Token360
Sign Up

Get Account Balance

GET/v1/billing/balance

Returns the current spendable balance for the authenticated account: wallet available balance plus credit available balance, in USD.

Authentication

Authorization Bearer

Use an API key in the Authorization header (sk-…).

Response

codeinteger

Response status code.

msgstring

Response message.

dataobject | null
data.currencystring

Balance currency; currently usd.

data.wallet_availablenumber

Wallet available balance in USD.

data.wallet_frozennumber

Wallet frozen balance in USD, such as pending settlement.

data.credit_availablenumber

Available credit balance in USD.

data.total_spendablenumber

wallet_available + credit_available.

data.checked_atstring

Snapshot time in UTC ISO-8601 format.

service_codestring | null

Stable service error code when applicable.

trace_idstring | null

Server trace id when available.

Balance Semantics

  • total_spendable is the same balance used for billing authorization: wallet top-up balance plus unused credit.
  • Enterprise members resolve wallet balances from the tenant owner account; credit remains on the member account when applicable.

Error Handling

  • 401 / unauthenticated: missing or invalid Authorization.
  • GET /v1/billing/{request_id} — reconcile charges for a single inference call.
  • GET /v1/billing — summarize account usage and charges over a date range.

Request

Shell
1curl -sS "https://api.token360.ai/v1/billing/balance" \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON
1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "currency": "usd",
6    "wallet_available": 12.5,
7    "wallet_frozen": 0,
8    "credit_available": 5,
9    "total_spendable": 17.5,
10    "checked_at": "2026-06-01T12:00:00Z"
11  },
12  "service_code": null,
13  "trace_id": null
14}
Was this page helpful?