Documentation Index
Fetch the complete documentation index at: https://docs.trustware.io/llms.txt
Use this file to discover all available pages before exploring further.
GET https://api.trustware.io/api/v1/data/balances/:address
Returns all token holdings for a wallet address across every supported chain simultaneously. Use this to populate an asset selector — the response includes token symbol, balance, decimals, USD price, and logo URI for each holding.
The response may arrive while balance data is still streaming in from some chains. Check the partial flag: if true, some chains have not yet responded and you may want to poll again or handle the incomplete state in your UI.
Path parameters
| Parameter | Description |
|---|
address | The wallet address to fetch balances for. EVM format (0x...). |
Response
{
"address": "0xeb212fe20f26243ec4d4df2dd49c8aa9fa75a201",
"partial": true,
"results": [
{
"chain_id": "1329",
"source": "alchemy",
"balances": [
{
"chain_key": "1329",
"category": "native",
"symbol": "SEI",
"decimals": 18,
"balance": "0"
}
],
"count": 1,
"error": null
},
{
"chain_id": "25",
"source": "fallback",
"balances": [
{
"chain_key": "25",
"category": "native",
"symbol": "CRO",
"decimals": 18,
"balance": "0"
}
],
"count": 1,
"error": null
}
]
}
Response fields
| Field | Description |
|---|
address | The queried wallet address. |
partial | true if the response is incomplete — some chains have not yet responded. |
results | Array of per-chain balance objects. |
results[].chain_id | Chain ID for this result set. |
results[].source | Data source used for this chain (alchemy, fallback, etc.). |
results[].balances | Array of token balances on this chain. |
results[].count | Number of tokens returned for this chain. |
results[].error | Error message if balance fetching failed for this chain, otherwise null. |
Balance object fields
| Field | Description |
|---|
chain_key | Chain identifier (matches chain_id for EVM chains; may be a string key for non-EVM). |
category | Token category: native, erc20, spl, or btc. |
contract | Token contract address (for ERC-20 and SPL tokens). |
symbol | Token ticker symbol. |
decimals | Token decimal places. Divide balance by 10^decimals for a human-readable amount. |
balance | Raw balance in the smallest unit of the token. |
name | Full token name. |
logoURI | Token logo image URL. |
usdPrice | Current USD price per token. |
Partial responses
When partial: true, some chains responded with an error or have not yet returned data. The results[].error field on each chain entry indicates if that chain encountered an issue. Chains with error: null returned successfully.
