Batch get token metadata
Batch retrieve token metadata for up to 100 addresses. Unknown addresses do not trigger an error; they are listed in missing instead. Duplicate addresses in the request are deduplicated in both tokens and missing, each in first-occurrence request order.
Request
- Base URL: https://api.blockvectra.com/v1/data
- URL: https://api.blockvectra.com/v1/data/{chain}/tokens:batch
- Auth: API key in header x-api-key
Path parameters
Chain identifier: the chain value of an entry in GET /chains (for example robinhood_mainnet), which lists every value this API accepts, i.e. the exact lowercase form of that entry's chain_slug. Matching is exact and case-sensitive; other spellings, aliases and numeric chain IDs are not accepted and return 404 not_found (unknown or not-public chain). What the chain serves differs per chain: see that entry's features and coverage.
Request body
Example request
{
"addresses": [
"0xAbCdEf0123456789aBcDeF0123456789aBCDEF01"
]
}Response
Found tokens plus the list of addresses that were not found.
Example response
{
"data": {
"tokens": [
{
"total_supply": "9007199254740993",
"metadata_updated_at": "2026-09-26T05:41:07Z"
}
]
},
"meta": {
"chain": "robinhood_mainnet",
"chain_slug": "ROBINHOOD_MAINNET",
"chain_external_id": "eip155:4663",
"refreshed_at": "2026-09-26T05:41:07Z"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.