> ## Documentation Index > Fetch the complete documentation index at: https://docs.spritz.finance/llms.txt > Use this file to discover all available pages before exploring further. # List wallet token balances > Returns multichain token balances for the supplied on-chain wallet address. Results are cached briefly per address. ## OpenAPI ````yaml https://platform.spritz.finance/openapi.json get /v1/wallet-kit/balances openapi: 3.0.3 info: title: Spritz Finance API version: 1.0.0 description: API for the Spritz Finance platform with RFC 9457 error handling servers: - url: https://platform.spritz.finance description: Production - url: https://sandbox.spritz.finance description: Sandbox security: [] tags: - name: Users description: User management endpoints - name: Bank Accounts description: Manage bank accounts for off-ramp destinations - name: Bills description: Manage bill pay accounts - name: Cards description: Spritz-issued debit cards - name: Auto-Ramp Accounts description: Virtual bank accounts that automatically convert fiat deposits to crypto - name: Spritz App description: >- Endpoints used by the Spritz app and internal SDKs. Excluded from the public partner spec. paths: /v1/wallet-kit/balances: get: tags: - Wallet Kit summary: List wallet token balances description: >- Returns multichain token balances for the supplied on-chain wallet address. Results are cached briefly per address. operationId: getV1Wallet-kitBalances parameters: - name: address in: query required: true schema: minLength: 1 description: >- On-chain wallet address to fetch balances for. EVM, Solana, and Sui address formats are supported. type: string example: '0x1234567890abcdef1234567890abcdef12345678' responses: '200': description: >- Paginated list of token balances for the requested on-chain wallet address. content: application/json: schema: description: >- Paginated list of token balances for the requested on-chain wallet address. type: object properties: data: description: >- Multichain token balances for the requested wallet address. type: array items: description: A token balance held by an on-chain wallet address. type: object properties: chain: description: Chain the token lives on type: string example: ethereum tokenAddress: description: On-chain token contract address type: string example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' walletAddress: description: Wallet address that holds the balance type: string example: '0x1234567890abcdef1234567890abcdef12345678' symbol: description: Token symbol type: string example: USDC name: description: Token name type: string example: USD Coin decimals: description: Token decimals type: integer example: 6 balance: description: Decimal-formatted token balance type: string example: '100.5' balanceRaw: description: Raw on-chain balance as an integer string type: string example: '100500000' balanceUsd: description: >- Balance value in USD, formatted to two decimal places type: string example: '100.50' price: description: Token price in USD, formatted to two decimal places type: string example: '1.00' tokenImageUrl: description: >- URL of the token's logo image, or empty string when unknown type: string example: https://assets.example.com/usdc.png required: - chain - tokenAddress - walletAddress - symbol - name - decimals - balance - balanceRaw - balanceUsd - price - tokenImageUrl hasMore: description: >- Whether more results are available beyond `data`. Always false for this resource — the full list is returned in a single response. type: boolean example: false nextCursor: type: string description: >- Opaque pagination cursor. Always null for this resource — the full list is returned in a single response. nullable: true required: - data - hasMore - nextCursor '401': description: Response for status 401 content: application/json: schema: type: object properties: type: default: about:blank description: A URI reference that identifies the problem type type: string example: urn:problem-type:auth:unauthorized title: description: A short, human-readable summary of the problem type type: string example: Unauthorized status: description: The HTTP status code type: number example: 401 detail: description: A human-readable explanation specific to this occurrence type: string example: Bearer token required instance: description: A URI reference that identifies the specific occurrence type: string realm: description: The authentication realm type: string example: API scope: description: The required scope for this resource type: string example: read:users required: - title - status additionalProperties: false '500': description: Response for status 500 content: application/json: schema: type: object properties: type: default: about:blank description: A URI reference that identifies the problem type type: string example: urn:problem-type:auth:unauthorized title: description: A short, human-readable summary of the problem type type: string example: Unauthorized status: description: The HTTP status code type: number example: 400 detail: description: A human-readable explanation specific to this occurrence type: string instance: description: A URI reference that identifies the specific occurrence type: string example: /errors/1234567890 code: description: >- Machine-readable cause, present when exactly one thing failed. Branch on this, never on `detail`, which is human-facing copy and may change. For deposit limits the vocabulary matches the `reason` values the limits API returns pre-flight. type: string example: transaction_limit field: description: The offending request field, present alongside `code`. type: string example: amountUsd retryable: description: >- Whether retrying the same request later may succeed without changing its inputs. type: boolean example: true required: - title - status additionalProperties: false security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Cognito JWT token for regular user authentication ````