WALLETS API

Query token balances for a wallet across multiple networks in a single request. This endpoint is priced at 0.0004 USD per settled call.

POST /balances

Attribute	Value
Method	POST
Description	Returns token balances grouped by network for the supplied wallet address.
Settlements	/, /solana, /base
Price	0.0004 USD

Request body

Field	Type	Required	Notes
walletAddress	string	yes	Checksummed address.
networks	array of integers	yes	At least one numeric network identifier.

Example body:

{
  "walletAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
  "networks": [1, 137]
}

Example request

curl -X POST "$NEURA_BASE_URL/balances" \
  -H "Content-Type: application/json" \
  -H "X-402-Invoice: $INVOICE" \
  -H "X-402-Payment-Proof: $PROOF" \
  -d '{"walletAddress":"0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6","networks":[1,137]}'

Response snapshot

{
  "success": true,
  "data": {
    "balances": [
      {
        "networkId": 1,
        "networkName": "Ethereum",
        "assets": [
          {
            "address": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "symbol": "USDC",
            "name": "USD Coin",
            "decimals": 6,
            "balance": "123456789000",
            "balanceUsd": 123456.789
          }
        ]
      },
      {
        "networkId": 137,
        "networkName": "Polygon",
        "assets": [
          {
            "address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
            "symbol": "USDC",
            "name": "USD Coin (PoS)",
            "decimals": 6,
            "balance": "987654321000",
            "balanceUsd": 98765.432
          }
        ]
      }
    ],
    "requestedNetworks": [1, 137],
    "walletAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
    "lastUpdated": "2025-01-15T12:50:00.000Z"
  },
  "timestamp": "2025-01-15T12:50:00.400Z"
}

Validation rules

• walletAddress must be provided; missing values return 400 with "walletAddress is required".

• networks must be a non-empty array of integers; values outside Neura’s supported list return a 400 error.

• Rate limit breaches produce 429 with a retryAfter hint.

See the Data Schemas page for a detailed breakdown of the response shape.