Get Balance

Return the prepaid balance of the account that owns this API key, in USD. Built for server-side monitoring: poll it and top up before the balance is exhausted. Values are live (`Cache-Control: no-store`). Alert on `balance` — the amount you can spend right now, gift credit included. While requests are in flight the gateway holds an estimated cost in `reserved_balance`; when each request settles, the unused part of the hold returns to `balance`, so `balance` can dip briefly under concurrency while `total_balance` stays steady. This endpoint has its own rate limit of 60 requests per minute per key and does not consume your inference rate limit.

curl -X GET "https://api.router.one/v1/balance"

{
  "object": "balance",
  "currency": "USD",
  "balance": 12.345678,
  "reserved_balance": 0.5,
  "total_balance": 12.845678
}

{
  "error": {
    "message": "invalid api key",
    "type": "authentication_error",
    "code": "AUTH_INVALID_API_KEY",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}

{
  "error": {
    "message": "rate limit exceeded",
    "type": "rate_limit_error",
    "code": "RATE_LIMIT_EXCEEDED",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}