{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/alchemy/refs/heads/main/json-schema/alchemy-token-api-token-balances-response-schema.json",
  "title": "Token Balances Response",
  "description": "JSON-RPC response containing token balance results.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "example": 1
    },
    "jsonrpc": {
      "type": "string",
      "example": "2.0"
    },
    "result": {
      "type": "object",
      "title": "Token Balances Result",
      "description": "Result payload for token balance queries.",
      "properties": {
        "address": {
          "type": "string",
          "description": "Wallet address queried.",
          "example": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174"
        },
        "tokenBalances": {
          "type": "array",
          "items": {
            "type": "object",
            "title": "Token Balance",
            "description": "ERC-20 token balance entry for a wallet address.",
            "properties": {
              "contractAddress": {
                "type": "string",
                "description": "Token contract address.",
                "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
              },
              "tokenBalance": {
                "type": "string",
                "description": "Token balance in hexadecimal (raw units, divide by 10^decimals).",
                "example": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000"
              },
              "error": {
                "type": "string",
                "nullable": true,
                "description": "Error message if the balance could not be retrieved.",
                "example": null
              }
            }
          },
          "description": "List of token balances for the wallet."
        },
        "pageKey": {
          "type": "string",
          "nullable": true,
          "description": "Pagination key for fetching the next page.",
          "example": null
        }
      }
    }
  }
}