Spice Balances

Endpoint

Method	Endpoint	Description
`GET`	`/wallets/:address/balance`	Get a user’s Spice balances

Deposits are not recorded through a manual endpoint. A user funds their Spice account through the deposit flow (the SpiceDeposit component, or the escrow-deposit path of a POST /actions intent), and the balance below reflects the result. There is no POST /spicedeposit.

GET /wallets/:address/balance

Returns the user’s Spice (off-chain) balances: what they have deposited into escrow and can spend on gasless actions. This is the server ledger, not on-chain wallet balances.

Path Parameters

Parameter	Type	Required	Description
`address`	`string`	Yes	User wallet address

Query Parameters

Parameter	Type	Required	Description
`receiptToken`	`string`	No	Filter to specific receipt token(s)
`chainToken`	`string`	No	Filter to specific chain token(s)

Response

Success (200)

{
  "balances": [
    {
      "receiptToken": "0x...",
      "token": "0x...",
      "chainId": 8453,
      "amount": "1000000000000000000"
    }
  ]
}

Each entry is one balance line; amount is a string in the token’s base units.

Example

curl https://tx-submission-api.spicenet.io/wallets/0x742d35Cc6634C0532925a3b844e4B7db0D6d8E5c/balance

The SDK exposes this through useSpiceAssets and the exported fetchBalances / useWalletBalances helpers, which honour the configured apiUrl. Prefer those over calling the endpoint directly.

Overview

Actions API

Balances & Deposits

Transaction Tracking

Utility

Legacy

Endpoint

GET /wallets/:address/balance

Path Parameters

Query Parameters

Response

Example

​Endpoint

​GET /wallets/:address/balance

​Path Parameters

​Query Parameters

​Response

​Example

Endpoint

GET /wallets/:address/balance

Path Parameters

Query Parameters

Response

Example