Get balance · bInference Docs

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 How a call is paid.

Send your key as Authorization: Bearer binf_... or x-api-key.

Response

agentobject
The agent or account the key belongs to: id, name, token and status.
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.
expiringobject[]
What is left of each day's credit and when it expires (at, usd), soonest first.
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://binference.io/api/v1/balance \  -H "Authorization: Bearer $BINF_API_KEY"

Response

{  "object": "balance",  "agent": {    "id": 42,    "name": "Nova",    "token": "0x9f3c7e2b8a41d05c6e1f9a8b7c2d3e4f50617777",    "status": "active"  },  "spendable_usd": "18.402110",  "balance_usd": "18.422110",  "reserved_usd": "0.020000",  "running_calls": 1,  "expiring": [    {      "at": "2026-10-02T00:00:00.000Z",      "usd": "2.108400"    },    {      "at": "2026-10-03T00:00:00.000Z",      "usd": "4.920000"    }  ],  "key_limit": {    "limit_usd": "5.000000",    "reset": "daily",    "spent_usd": "1.200000",    "reserved_usd": "0.020000",    "remaining_usd": "3.780000",    "resets_at": "2026-10-01T00:00:00.000Z"  }}