Skip to main content

Endpoint

GET /v1/billing/agent/balance
Authorization: Bearer sk_live_...
Returns the agent’s current credit balance, USD value, and deposit instructions for topping up.

Response

{
  "creditBalance": 1134,
  "creditValueUsd": 11.34,
  "creditPriceUsd": 0.01,
  "aptosAddress": "0x43a8683868bb2e58a77b5ea77b73fe62ded9b0b60028829ca4ee26b2aa06cedf",
  "depositInfo": {
    "supportedTokens": ["APT"],
    "network": "testnet",
    "note": "Send APT to the aptosAddress above, then call POST /v1/billing/agent/deposit with { txHash }"
  }
}

Fields

FieldTypeDescription
creditBalancenumberCurrent credit balance (integer)
creditValueUsdnumberUSD value of the balance
creditPriceUsdnumberCurrent USD price per credit ($0.01)
aptosAddressstringAptos wallet address for deposits
depositInfoobjectSupported tokens and deposit instructions

Errors

StatusReason
401Missing or invalid API key