{
  "endpoint": "synternet.wallet-info.balances",
  "description": "Fetch wallet balances across multiple blockchain networks, providing a unified view of token holdings",
  "payload": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string",
        "description": "Chain identifier (e.g., 'ethereum', 'bitcoin', 'solana')"
      },
      "address": {
        "type": "string",
        "description": "Wallet address on the specified chain"
      }
    },
    "required": ["chain", "address"]
  },
  "response": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string",
        "description": "Chain identifier of the queried wallet"
      },
      "balances": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Full name of the token"
            },
            "symbol": {
              "type": "string",
              "description": "Token symbol"
            },
            "address": {
              "type": "string",
              "description": "Token contract address (empty for native chain tokens)"
            },
            "balance": {
              "type": "float",
              "description": "Token balance in decimal format"
            }
          }
        }
      }
    }
  },
  "examples": {
    "Request": {
      "chain": "ethereum",
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
    },
    "Response": {
      "chain": "ethereum",
      "balances": [
        {
          "name": "Ethereum",
          "symbol": "ETH",
          "address": "",
          "balance": 1.5243
        },
        {
          "name": "USD Coin",
          "symbol": "USDC",
          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "balance": 1000.0
        }
      ]
    }
  },
  "notes": [
    "Returns unified token balances for a specified wallet address",
    "Empty address field indicates native chain token",
    "Balances are returned in decimal format with appropriate precision",
    "Small balances (under $0.01 USD) are filtered out",
    "Results are cached for 1 minute to optimize performance",
    "Supports multiple blockchain networks",
    "Native chain tokens (ETH, BTC, SOL) are always shown first in the balances array"
  ],
  "update_frequency": "Real-time with 1-minute cache"
}