Token Metadata API
Fetch token contract metadata such as symbol, name, decimals, and total supply, for one contract or in batch.
Endpoints
| Method | Path | Description | CU / Call | USD / 1M Calls | Calls per free cycle (approx.) |
|---|---|---|---|---|---|
| GET | /{chain}/tokens/{token} | Get token metadata | 5 | $0.50 | 6,000,000 |
| POST | /{chain}/tokens:batch | Batch get token metadata | 10 | $1.00 | 3,000,000 |
Free plan: all keys in your account share an average of 25 calls per second.
Response fields
GET/{chain}/tokens/{token}
| Field | Type |
|---|---|
| address | string |
| standard | string |
| name | string | null |
| symbol | string | null |
| decimals | integer | null |
| total_supply | string | null |
| first_seen_block | integer |
| metadata_updated_at | string |
| metadata_block | integer |
| metadata_status | string |
| metadata_issues | object |
POST/{chain}/tokens:batch
| Field | Type |
|---|---|
| tokens | array |
| missing | array |
Available on Chains
Quick example
curl -s "https://api.blockvectra.com/v1/data/arb_mainnet/tokens/{token}" -H "x-api-key: {api_key}"Documentation
Try this dataset for free
Get 30M CU on sign-up, refilled every 30 days.
Data API bills only successful responses.