Wallets
Get Token Balance
Get the balance of a specific token for a wallet
GET
Notes
- The
balancefield is a raw integer string. Divide by10^decimalsto get the human-readable amount. In the example above,15000000 / 10^6 = 15.0 USDC. - You can identify the wallet by either
externalUserIdorwalletPublicKey. At least one is required.
Authorizations
Bearer token — use your secret key (sk_prod_xxx) for server-side calls, or the user's JWT for client-side calls
Your Chipi public API key (pk_xxx)
Query Parameters
Your application's user identifier (provide this or walletPublicKey)
The wallet's public key / address (provide this or externalUserId)
The token to query Token identifier
Available options:
USDC, USDC_E, USDT, DAI, ETH, STRK, SLINK, ALF, BROTHER, ARB, DOC, MXNB, WLD, WBTC, OTHER The blockchain network Blockchain network identifier
Available options:
STARKNET, BASE, ARBITRUM, OPTIMISM, ROOTSTOCK, SCROLL, WORLDCHAIN Response
Token balance
Blockchain network identifier
Available options:
STARKNET, BASE, ARBITRUM, OPTIMISM, ROOTSTOCK, SCROLL, WORLDCHAIN Token identifier
Available options:
USDC, USDC_E, USDT, DAI, ETH, STRK, SLINK, ALF, BROTHER, ARB, DOC, MXNB, WLD, WBTC, OTHER The token's contract address on the chain
Number of decimal places for the token
The raw balance (divide by 10^decimals for human-readable amount)
