Tokens
Token metadata, listings with market data, ACE lists, and price history.
Token List
GET
/v1/tokens?request=listPaginated list of all indexed tokens with optional market statistics.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | optional | list | Must be `list` (default) |
| limit | int | optional | 50 | Number of results (1–100) |
| offset | int | optional | 0 | Pagination offset |
| symbol | string | optional | — | Filter by contract ID (exact, case-insensitive) |
| type | string | optional | — | Filter: token, nft, or sbt |
| sort | string | optional | market_cap | Sort: market_cap, name, volume, change, holders, transactions, created, symbol |
| order | string | optional | desc | Sort direction: asc or desc |
| include | string | optional | — | Sections to include: supply, market, fees, governance, icons, project, all |
🪙 Usage & Credits
This endpoint consumes 5 credits per request against your active API tier.
Response
json
{
"found": "integer",
"tokens": [
{
"symbol": "string",
"name": "string",
"type": "string",
"icon": "string *"
}
]
}Token Info
GET
/v1/tokens?request=infoDetailed metadata for a specific token. Supports bridge mint resolution.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `info` |
| symbol | string | REQUIRED | — | Contract ID (e.g. $ZRA+0000) |
| include | string | optional | — | Sections: supply, market, fees, governance, icons, project, all |
🪙 Usage & Credits
This endpoint consumes 10 credits per request against your active API tier.
Response
json
{
"symbol": "string",
"name": "string",
"type": "string",
"icon": "string *",
"supply *": {
"totalSupply": "float",
"maxSupply": "float *",
"circulatingSupply": "float",
"burnedSupply": "float *",
"mintedSupply": "float *",
"partsPerToken": "float"
},
"market *": {
"marketCap": "float",
"volume24hr": "float",
"change24hr": "float",
"rate": "float *",
"holders": "integer",
"transactions": "integer",
"isAceAuthorized": "boolean"
},
"fees *": {
"feeType": "string",
"totalFee": "string",
"burnPercent": "integer",
"validatorPercent": "integer",
"otherPercent": "integer",
"feeAddress": "string *",
"acceptedFeeContracts": "array *"
},
"governance *": {
"type": "string",
"activeProposals": "integer",
"totalProposals": "integer",
"threshold": "integer",
"quorum": "integer",
"fastQuorum": "integer *",
"durationDays": "integer *",
"durationMonths": "integer *",
"startCycleUnix": "integer *",
"endCycleUnix": "integer *",
"numberStages": "integer *",
"currentStageNumber": "integer *",
"stages *": [
{
"stageNumber": "integer",
"isBreak": "boolean",
"period": "string",
"length": "integer",
"maxAllowed": "integer *",
"startsAt": "integer *",
"endsAt": "integer *"
}
]
},
"icons *": {
"lowRes": "string *",
"highRes": "string *"
},
"project *": {
"projectUrl": "string *",
"exchangeInfo": "string *",
"generalInfo": "string *"
},
"bridge *": {
"mints": [
{
"network": "string",
"mintId": "string"
}
]
}
}Errors
| Status | Condition |
|---|---|
| 400 | Missing symbol parameter |
| 404 | Token not found |
ACE Authorized Tokens
GET
/v1/tokens?request=authorizedTokens authorized for ACE (Authorized Currency Equivalent) base fee payments.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `authorized` |
| address | string | optional | — | Filter to ACE tokens the wallet holds |
| type | string | optional | — | Filter: token, nft, sbt |
| include | string | optional | — | Sections to include |
🪙 Usage & Credits
This endpoint consumes 10 credits per request against your active API tier.
Response
json
{
"found": "integer",
"tokens": [
{
"symbol": "string",
"name": "string",
"type": "string",
"icon": "string *"
}
]
}Price History
GET
/v1/tokens?request=priceHistoryTime-bucketed historical price data for charting.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `priceHistory` |
| symbol | string | REQUIRED | — | Contract ID |
| interval | string | optional | 1h | Bucket: 5m, 15m, 1h, 4h, 1d |
| startTime | int | optional | — | Unix timestamp lower bound |
| endTime | int | optional | — | Unix timestamp upper bound |
| limit | int | optional | 500 | Max data points (1–2000) |
🪙 Usage & Credits
This endpoint consumes 10 credits per request against your active API tier.
Response
json
{
"found": "integer",
"symbol": "string",
"interval": "string",
"prices": [
{
"time": "integer",
"price": "float"
}
]
}