Wallets
Wallet balance lookups, token holdings, NFT/SBT items, and existence checks.
Wallet Balance
GET
/v1/wallets?requestType=balanceRetrieve token balances for a wallet. Supports filtering by symbol, type, and text search.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| requestType | string | REQUIRED | — | Must be `balance` |
| address | string | REQUIRED | — | Wallet address |
| offset | int | optional | 0 | Pagination offset |
| limit | int | optional | 100 | Results per page |
| symbol | string | optional | — | Filter by contract ID(s), comma-separated |
| filter | string | optional | — | Set to "items" for NFT/SBT items |
| searchTerm | string | optional | — | Free-text search against name/symbol |
| sort | string | optional | — | Sort order |
🪙 Usage & Credits
This endpoint consumes 25 credits per request against your active API tier.
Response
json
// When filter != "items" (default — token balances):
{
"totalValue": "float *",
"zraRate": "float *",
"found": "integer",
"tokens": [
{
"symbol": "string",
"name": "string",
"icon": "string *",
"amount": "string (integer) *",
"parts": "string (integer) *",
"rate": "float *",
"value": "float *",
"market_cap": "float *",
"stat_last_update": "integer *",
"changePercent": "float *",
"type": "string",
"aceAuthorized": "boolean *"
}
]
}
// When filter = "items" (NFT/SBT items):
{
"found": "integer",
"items": [
{
"contractInfo": {
"symbol": "string",
"name": "string",
"icon": "string *",
"type": "string",
"items": "integer"
},
"items": [
{
"itemID": "string (integer) *",
"icon": "string *"
}
]
}
]
}Wallet Exists
GET
/v1/wallets?requestType=existsCheck whether a wallet/token combination exists on-chain.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| requestType | string | REQUIRED | — | Must be `exists` |
| address | string | REQUIRED | — | Wallet address to check |
| symbol | string | optional | — | Contract ID for specific token check |
🪙 Usage & Credits
This endpoint consumes 1 credit per request against your active API tier.
Response
json
{
"exists": "boolean"
}