Skip to main content
GET
Token - Metadata (Single)

Lightweight token identity lookup.

  • Always use the checksum contract address on EVM chains and the canonical token mint address on Solana-like chains.
  • Token metadata can vary by chain and token standard.
  • Response may be null or missing fields if metadata is not indexed or unavailable.
  • Use this endpoint when fetching metadata for one token; use the multiple endpoint for batch lookups.
  • Cache token metadata where possible because it changes less frequently than market data.
  • This endpoint consumes 3 CU per request.
  • Display token names, symbols, decimals, and logos in portfolios, token pages, and trading interfaces.
  • Enrich search results, watchlists, and token cards before adding price or liquidity data.
  • Normalize token display across chains using one metadata lookup pattern.
  • Validate token identity before running analytics, alerts, or token-screening workflows.
  • Provide address as the token address and set x-chain for the target network.
  • Use the multiple metadata endpoint when you need to hydrate a list of tokens.
  • Cache metadata because it changes much less often than price, liquidity, or trading activity.
  • Fetch metadata before rendering token tables so users see readable names and symbols instead of raw addresses.
  • Join metadata with market-data or price endpoints for richer token cards.
  • Store decimals with the token record so downstream amount formatting stays consistent.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

A chain name listed in supported networks.

Available options:
solana,
ethereum,
bsc,
base,
robinhood,
sui,
mantle,
hyperevm,
arbitrum,
avalanche,
optimism,
polygon,
zksync,
monad,
aptos,
fogo,
megaeth

Query Parameters

address
string
required

The address of the token contract.

Response

JSON object containing metadata of a specific token

success
boolean
required

Whether the request completed successfully.

data
object
required