Holdings
Liquid balances a wallet holds directly, outside any protocol position.
https://api.syncrone.fi/api/holdingsRetrieve token holdings data across organizations, wallets and chains. Holdings represent direct token balances held by wallets, excluding DeFi protocol positions.
Supports filtering by wallet, chain, time range, and asset address.
Request#
Send the API key in the x-api-Key header. List endpoints cap limit at 500. When page_info.has_more is true, pass page_info.next_cursor back as next_cursor.
curl "https://api.syncrone.fi/api/holdings?limit=100" \
-H "x-api-Key: $SYNCRONE_API_KEY"Parameters#
| Name | Type | Description |
|---|---|---|
| chain_id | integer | Blockchain network ID (e.g., 1 for Ethereum mainnet, 137 for Polygon) |
| chain | string | Blockchain network name (alternative to chain_id) |
| wallet | string | Wallet address to filter by |
| from_date | date-time | Start date for time range filter (ISO 8601 format) |
| to_date | date-time | End date for time range filter (ISO 8601 format) |
| from_block | string | Start block number for filtering |
| to_block | string | End block number for filtering |
| via_proxy | string | Proxy contract address if interaction was through a proxy |
| snapshot_mode | stringall | daily_only | interaction_only | harmonized_only | Filter by snapshot capture mode:
|
| next_cursor | date-time | Pagination cursor from previous response |
| limit | integer | Maximum number of results to return (capped at 500) |
| holding_id | string | Unique identifier for a specific holding |
| asset_address | string | Token contract address |
| validate | stringtrue | 1 | Enable data quality validation (returns only WARNINGS) |
Response#
200 returns HoldingsResponse. Field definitions for nested objects live on the models page.
Errors#
| Status | Meaning |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 404 | Not Found - No data found matching the criteria |
| 500 | Internal Server Error |
Error bodies use the Error object: error, message, and statusCode.