Skip to content
Alchemy Logo

Spot clearinghouse state

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

ParameterTypeRequiredDescription
typestringYesSelects spotClearinghouseState.
userstringYesMaster or sub-account address.
{
  "type": "spotClearinghouseState",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
balances[]arrayBalance entries.
balances[].coinstringSpot-token symbol, for example USDC.
balances[].tokenintegerNumeric token index from the spot metadata response.
balances[].holdstringAmount reserved by orders.
balances[].totalstringCombined balance held by the account, as a decimal string.
balances[].entryNtlstringEntry notional for this token balance, as a decimal string.

{
  "balances": [
    {
      "coin": "USDC",
      "token": 0,
      "hold": "0.0",
      "total": "14.625485",
      "entryNtl": "0.0"
    }
  ]
}
Was this page helpful?