v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Onchain

Batch get token metadata

Fetch metadata for multiple tokens in a single request. Provide comma-separated networks and addresses in the same order. Maximum 100 tokens per request.

get/v2/onchain/token/metadata/batch

Query parameters

networksstring required

Example:base

Comma-separated list of blockchain networks. Each value must be a valid network (ethereum, optimism, base, arbitrum, robinhood).

addressesstring required

Example:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Comma-separated list of token contract addresses corresponding to each network

Response

Success

Example response

{
  "tokens": [
    {
      "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "decimals": 6,
      "description": "USDC is a fully collateralized US dollar stablecoin",
      "fdv": "25000000000",
      "holder_count": 1500000,
      "image_url": "https://example.com/token.png",
      "liquidity": "500000000",
      "market_cap": "25000000000",
      "name": "USD Coin",
      "price_change_24h_pct": -1.2,
      "price_change_6h_pct": 0.5,
      "price_source": "onchain",
      "price_updated_at": 1707177600000,
      "price_usd": "1.00",
      "symbol": "USDC",
      "total_supply": "1000000000000",
      "volume_24h": "150000000",
      "volume_6h": "50000000"
    }
  ]
}