Skip to main content
GET
/
v2
/
account
/
usage
Get Usage
curl --request GET \
  --url https://api.tusky.io/v2/account/usage
{
  "uploads": 123,
  "deletions": 123,
  "extends": 123,
  "ingressBytes": 123,
  "egressBytes": 123,
  "usedBytes": 123,
  "activeFiles": 123,
  "expiredFiles": 123,
  "blobs": 123,
  "quilts": 123,
  "environments": 123,
  "publishers": 123,
  "aggregators": 123,
  "suiSpent": "<string>",
  "walSpent": "<string>"
}
Retrieve usage statistics for the authenticated account.

​
Query Parameters

​
from
string
Start of the period (ISO 8601). Defaults to 30 days ago.
​
to
string
End of the period (ISO 8601). Defaults to now.

​
Response

​
uploads
number
Number of file uploads in the period.
​
deletions
number
Number of file deletions in the period.
​
extends
number
Number of storage extensions in the period.
​
ingressBytes
number
Data uploaded in the period (bytes).
​
egressBytes
number
Data downloaded / served via aggregators in the period (bytes).
​
usedBytes
number
Total bytes currently stored on Walrus.
​
activeFiles
number
Number of active files.
​
expiredFiles
number
Number of files whose storage epochs have already expired.
​
blobs
number
Number of Walrus blobs currently stored (standalone blobs).
​
quilts
number
Number of Walrus quilts currently stored (batched blobs).
​
environments
number
Number of environments on the account.
​
publishers
number
Number of publishers on the account.
​
aggregators
number
Number of aggregators on the account.
​
suiSpent
string
SUI spent in the period (gas fees + conversions).
​
walSpent
string
WAL spent in the period (Walrus storage).

​
Example

curl "https://api.tusky.io/v2/account/usage?from=2026-03-01T00:00:00Z&to=2026-03-07T23:59:59Z" \
  -H "Api-Key: YOUR_API_KEY"

​
Response

{
  "uploads": 3120,
  "deletions": 45,
  "extends": 35,
  "ingressBytes": 5368709120,
  "egressBytes": 21474836480,
  "usedBytes": 85236940800,
  "activeFiles": 4520,
  "expiredFiles": 18,
  "blobs": 312,
  "quilts": 89,
  "environments": 3,
  "publishers": 4,
  "aggregators": 2,
  "suiSpent": "12.45",
  "walSpent": "38.2"
}