Neynar · Example Payload
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.
Onchain
Batch Get Token Metadata is an example object payload from Neynar, with 9 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
operationIdmethodpathsummarydescriptiontagsparametersrequestBodyresponses
Example Payload
{
"operationId": "batch-get-token-metadata",
"method": "GET",
"path": "/v2/onchain/token/metadata/batch",
"summary": "Batch get token metadata",
"description": "Fetch metadata for multiple tokens in a single request. Provide comma-separated networks and addresses in the same order. Maximum 100 tokens per request.",
"tags": [
"Onchain"
],
"parameters": [
{
"name": "networks",
"in": "query",
"required": true,
"description": "Comma-separated list of blockchain networks. Each value must be a valid network (ethereum, optimism, base, arbitrum).",
"schema": {
"example": "base",
"type": "string",
"x-comma-separated": true
}
},
{
"name": "addresses",
"in": "query",
"required": true,
"description": "Comma-separated list of token contract addresses corresponding to each network",
"schema": {
"example": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"type": "string",
"x-comma-separated": true
}
}
],
"requestBody": null,
"responses": {
"200": {
"description": "Success",
"schema": {
"properties": {
"tokens": {
"items": {
"nullable": true,
"properties": {
"address": {
"description": "Token contract address",
"example": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"decimals": {
"description": "Token decimals",
"example": 6,
"type": "integer"
},
"description": {
"description": "Token description",
"example": "USDC is a fully collateralized US dollar stablecoin",
"nullable": true,
"type": "string"
},
"fdv": {
"description": "Fully diluted valuation in USD",
"example": "25000000000",
"nullable": true,
"type": "string"
},
"holder_count": {
"description": "Number of token holders",
"example": 1500000,
"nullable": true,
"type": "integer"
},
"image_url": {
"description": "Token logo URL",
"example": "https://example.com/token.png",
"nullable": true,
"type": "string"
},
"liquidity": {
"description": "Total liquidity in USD",
"example": "500000000",
"nullable": true,
"type": "string"
},
"market_cap": {
"description": "Market capitalization in USD",
"example": "25000000000",
"nullable": true,
"type": "string"
},
"name": {
"description": "Token name",
"example": "USD Coin",
"type": "string"
},
"network": {
"$ref": "#/components/schemas/Network"
},
"price_change_24h_pct": {
"description": "24-hour price change percentage",
"example": -1.2,
"nullable": true,
"type": "number"
},
"price_change_6h_pct": {
"description": "6-hour price change percentage",
"example": 0.5,
"nullable": true,
"type": "number"
},
"price_source": {
"description": "Source of price data",
"enum": [
"onchain",
"coingecko"
],
"example": "onchain",
"nullable": true,
"type": "string"
},
"price_updated_at": {
"description": "Timestamp when price data was last updated (milliseconds)",
"example": 1707177600000,
"nullable": true,
"type": "integer"
},
"price_usd": {
"description": "Token price in USD",
"example": "1.00",
"nullable": true,
"type": "string"
},
"symbol": {
"description": "Token symbol",
"example": "USDC",
"type": "string"
},
"total_supply": {
"description": "Total token supply",
"example": "1000000000000",
"nullable": true,
"type": "string"
},
"volume_24h": {
"description": "24-hour trading volume in USD",
"example": "150000000",
"nullable": true,
"type": "string"
},
"volume_6h": {
"description": "6-hour trading volume in USD",
"example": "50000000",
"nullable": true,
"type": "string"
}
},
"required": [
"network",
"address",
"name",
"symbol",
"decimals",
"total_supply",
"image_url",
"price_usd",
"market_cap",
"fdv",
"liquidity",
"volume_6h",
"volume_24h",
"price_change_6h_pct",
"price_change_24h_pct",
"holder_count",
"description",
"price_updated_at",
"price_source"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"tokens"
],
"type": "object"
},
"example": null
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/components/schemas/ErrorRes"
},
"example": null
},
"500": {
"description": "Server Error",
"schema": {
"$ref": "#/components/schemas/ErrorRes"
},
"example": null
}
}
}