---
title: "Get token metadata"
method: GET
path: "/v2/onchain/token/metadata"
tags: ["Onchain"]
---

# Get token metadata

`GET /v2/onchain/token/metadata`

Fetch metadata for a specific token including price, market data, and basic information. Data is fetched from onchain-indexer with fallback to third-party providers.

## Query parameters

- `network` 'ethereum' | 'optimism' | 'base' | 'arbitrum' | 'robinhood', required
- `address` string, required

## Response `200`

Success

- object
  - `token` object, required
    - `address` string, required — Token contract address
    - `decimals` integer, required — Token decimals
    - `description` string, nullable, required — Token description
    - `fdv` string, nullable, required — Fully diluted valuation in USD
    - `holder_count` integer, nullable, required — Number of token holders
    - `image_url` string, nullable, required — Token logo URL
    - `liquidity` string, nullable, required — Total liquidity in USD
    - `market_cap` string, nullable, required — Market capitalization in USD
    - `name` string, required — Token name
    - `network` 'ethereum' | 'optimism' | 'base' | 'arbitrum' | 'robinhood', required — A blockchain network e.g. "ethereum", "optimism", "base", "arbitrum", "robinhood"
    - `price_change_24h_pct` number, nullable, required — 24-hour price change percentage
    - `price_change_6h_pct` number, nullable, required — 6-hour price change percentage
    - `price_source` 'onchain' | 'coingecko', nullable, required — Source of price data
    - `price_updated_at` integer, nullable, required — Timestamp when price data was last updated (milliseconds)
    - `price_usd` string, nullable, required — Token price in USD
    - `symbol` string, required — Token symbol
    - `total_supply` string, nullable, required — Total token supply
    - `volume_24h` string, nullable, required — 24-hour trading volume in USD
    - `volume_6h` string, nullable, required — 6-hour trading volume in USD

## Other responses

- `400` — Bad Request
- `404` — Resource not found
- `500` — Server Error

---

[API](https://skmtc.net/neynar/apis/neynar-api.md) · [All operations](https://skmtc.net/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neynar/neynar-api/versions/dbb91bfb0d1a/schema)