Skip to main content
POST
/
v1
/
trpc
/
v2.wallets.balances
tRPC V2 Wallet Balances API
curl --request POST \
  --url https://api.glider.fi/v1/trpc/v2.wallets.balances \
  --header 'X-API-KEY: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.glider.fi/llms.txt

Use this file to discover all available pages before exploring further.

The v2.wallets.balances procedure returns a normalized, priced balance view for the active connected wallet session. It is intended for product UX surfaces such as deposit asset pickers, Max and percentage shortcuts, USD estimates, and disabled states.
  • Base endpoint: POST /v1/trpc
  • Procedure: v2.wallets.balances
  • Auth: wallet session plus app access
  • Supported chains: EIP-155 assets
  • Scope: active session wallet only
  • Asset limit: 100 CAIP asset ids per request
This response is advisory UI state. Final execution validation still happens at simulation/send time, because a user can move funds after the balance snapshot is read.

​
Input

{
  "address": "0x1111111111111111111111111111111111111111",
  "assetIds": [
    "eip155:8453/erc20:0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "eip155:8453/slip44:60"
  ],
  "chainIds": [8453]
}
  • address is optional when the active wallet session already resolves an EVM wallet address.
  • When supplied, address must match the active wallet session. The procedure must not be used as a generic wallet-balance oracle.
  • assetIds must be CAIP asset ids from Glider’s supported asset universe.
  • chainIds optionally narrows the lookup to one or more EIP-155 chains.

​
Response

{
  "address": "0x1111111111111111111111111111111111111111",
  "asOf": "2026-05-12T00:00:00.000Z",
  "balances": [
    {
      "assetId": "eip155:8453/erc20:0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "chainId": 8453,
      "symbol": "USDC",
      "contractAddress": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "decimals": 6,
      "rawAmount": "4200000000",
      "amount": "4200",
      "usdPrice": "1",
      "usdValue": "4200.00",
      "stale": false
    }
  ],
  "warnings": []
}

​
Warning Kinds

  • INVALID_ASSET_ID: the supplied asset id could not be parsed.
  • MISSING_ASSET: the asset is not in the supported asset universe.
  • BLOCKLISTED_ASSET: the asset is blocklisted and should not be offered.
  • UNSUPPORTED_CHAIN: the asset is not currently readable through the connected wallet balance service.
  • RPC_ERROR: backend balance reading failed for a chain.
  • MISSING_PRICE: the balance was readable, but no USD price was available.

​
Runtime Notes

The backend owns RPC quality, batching, retries, supported-asset filtering, decimal normalization, price hydration, and short-lived cache behavior. Browser wallet libraries still own connected wallet identity, chain/account state, and signing or transaction submission.