Skip to main content
GET
/
v2
/
onchain
/
token
/
metadata
/
batch
Batch get token metadata
curl --request GET \
  --url https://api.neynar.com/v2/onchain/token/metadata/batch \
  --header 'x-api-key: <api-key>'
{
  "tokens": [
    {
      "network": "ethereum",
      "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "total_supply": "1000000000000",
      "image_url": "https://example.com/token.png",
      "price_usd": "1.00",
      "market_cap": "25000000000",
      "fdv": "25000000000",
      "liquidity": "500000000",
      "volume_6h": "50000000",
      "volume_24h": "150000000",
      "price_change_6h_pct": 0.5,
      "price_change_24h_pct": -1.2,
      "holder_count": 1500000,
      "description": "USDC is a fully collateralized US dollar stablecoin",
      "price_updated_at": 1707177600000,
      "price_source": "onchain"
    }
  ]
}

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

networks
string
required

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

Example:

"base"

addresses
string
required

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

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

Response

Success

tokens
(object | null)[]
required