This API is in private preview. Target October 2026; timing is subject to change.
Returns a user's spot balances for account-state and balance checks.
Available now. This read is served at the interim endpoint today.
POST /{apiKey}/info
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Selects spotClearinghouseState. |
user | string | Yes | Master or sub-account address. |
{
"type": "spotClearinghouseState",
"user": "0x0000000000000000000000000000000000000000"
}| Field | Type | Description |
|---|---|---|
balances[] | array | Balance entries. |
balances[].coin | string | Spot-token symbol, for example USDC. |
balances[].token | integer | Numeric token index from the spot metadata response. |
balances[].hold | string | Amount reserved by orders. |
balances[].total | string | Combined balance held by the account, as a decimal string. |
balances[].entryNtl | string | Entry notional for this token balance, as a decimal string. |
{
"balances": [
{
"coin": "USDC",
"token": 0,
"hold": "0.0",
"total": "14.625485",
"entryNtl": "0.0"
}
]
}