Get balance

GETTry it

Read it before a batch of calls to size them, or to show your users what's left. Amounts are dollars as exact decimal strings.

spendable_usd is what new calls can reserve right now: the balance less what running calls hold. Compare it with a call's reserve, not with its likely cost. See AI credit.

Send a router key as Authorization: Bearer rf_ai_... or x-api-key.

Response

accountobject
The credit account the key spends: its id (acc_...) and its token, with the token's mint, symbol and name.
spendable_usdstring
What new calls can reserve right now: the balance less what running calls hold.
balance_usdstring
The whole balance.
reserved_usdstring
What running calls hold.
running_callsinteger
Calls running now, at most 8.
key_limitobject | null
This key's spending limit, if it has one: limit_usd, reset (daily, weekly or monthly), spent_usd, reserved_usd, remaining_usd and resets_at.

Request

curl https://relayfor.si/api/v1/balance \  -H "Authorization: Bearer $RELAYFOR_ROUTER_KEY"

Response

{  "object": "balance",  "account": {    "id": "acc_arqp1qhbpvjhzifE",    "token": {      "mint": "MASi45ub7Qe4ZE36UT5G6cU4ud8Fhhe4deS4F3cw9KTA",      "symbol": "NOVA",      "name": "Nova"    }  },  "spendable_usd": "18.40211",  "balance_usd": "18.42211",  "reserved_usd": "0.02",  "running_calls": 1,  "key_limit": {    "limit_usd": "5",    "reset": "daily",    "spent_usd": "1.2",    "reserved_usd": "0.02",    "remaining_usd": "3.78",    "resets_at": "2026-10-01T00:00:00.000Z"  }}