Sign in
Billing

Get historical data of billing and usage for a wallet address.

get/v1/usage/history

Query parameters

addressstring required

The wallet address to get billing and usage data for

Example:akash18andxgtd6r08zzfpcdqg9pdr6smks7gv76tyt6
startDatestring date

Start date (YYYY-MM-DD). Defaults to 30 days before endDate

Example:2024-01-01
endDatestring date

End date (YYYY-MM-DD). Defaults to today by UTC 23:59:59

Example:2024-01-31

Response

Returns billing and usage data

datestring required

Date in YYYY-MM-DD format

activeDeploymentsnumber required

Number of active deployments on this date

dailyAktSpentnumber required

AKT tokens spent on this date

totalAktSpentnumber required

Cumulative AKT tokens spent up to this date

dailyUsdcSpentnumber required

USDC spent on this date

totalUsdcSpentnumber required

Cumulative USDC spent up to this date

dailyActSpentnumber required

ACT spent on this date (includes legacy USDC)

totalActSpentnumber required

Cumulative ACT spent up to this date (includes legacy USDC)

dailyUsdSpentnumber required

Total USD value spent on this date (AKT + USDC)

totalUsdSpentnumber required

Cumulative USD value spent up to this date

Example response

[
  {
    "date": "2024-01-15",
    "activeDeployments": 3,
    "dailyAktSpent": 12.5,
    "totalAktSpent": 125.75,
    "dailyUsdcSpent": 5.25,
    "totalUsdcSpent": 52.5,
    "dailyActSpent": 5.25,
    "totalActSpent": 52.5,
    "dailyUsdSpent": 17.75,
    "totalUsdSpent": 178.25
  }
]

Changes

Changed in 9 of the 25 revisions of this API.9

  • ae76edbfc7f21See the full diff
    • ▲

      for the query request parameter endDate, default value 2026-07-20 was removed

      request-parameter-default-value-removed

  • c3b0e234fc131See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-06-26 to 2026-07-20

      request-parameter-default-value-changed

  • be2e5614d7541See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-06-17 to 2026-06-26

      request-parameter-default-value-changed

  • b1975c50c4ba1See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-05-20 to 2026-06-17

      request-parameter-default-value-changed

  • 1f950a9aba801See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-05-14 to 2026-05-20

      request-parameter-default-value-changed

  • 63b6ade4ec641See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-05-12 to 2026-05-14

      request-parameter-default-value-changed

  • 426a29134b9d1See the full diff
    • ▲

      for the query request parameter endDate, default value 2026-05-12 was added

      request-parameter-default-value-added

  • 1c1eaa6f8dc71See the full diff
    • ▲

      for the query request parameter endDate, default value 2026-05-06 was removed

      request-parameter-default-value-removed

  • 967c41f608441See the full diff
    • ▲

      for the query request parameter endDate, default value was changed from 2026-06-26 to 2026-05-06

      request-parameter-default-value-changed