Skip to main content
The Tokens data product is the canonical source of truth for every fungible token ChainStream indexes. One schema, one address space per chain, one set of fields — whether you’re looking up a blue-chip ERC-20, a brand-new Solana meme coin or a BSC pair.

​
What’s inside

Field groupExamples
IdentitychainId, address, name, symbol, decimals, logo
MarketpriceUsd, priceChange24h, marketCap, fdv, volume24h
SupplytotalSupply, circulatingSupply, holderCount
CreationcreatedAtBlock, creatorAddress, firstTxHash, launchpad
SecurityisHoneypot, canBuy, canSell, taxBuy, taxSell, owner
Socialwebsite, twitter, telegram, verifiedSources
Security and social fields are best-effort — see Data Freshness for confidence levels.

​
Coverage & freshness

Chains

Solana, Ethereum, BSC, Base, Polygon, Arbitrum, Optimism, Avalanche, zkSync, Sui — plus anything in Supported Chains.

Freshness

Metadata: minutes after creation. Market data: seconds (near-real-time). Creation events: block-level (sub-second on Solana, 1–12 s on EVM).

​
Access

REST — lookup & search

/v2/token/search, /v2/token/{chain}/{tokenAddress}, /v2/token/{chain}/metadata/multi, /v2/token/{chain}/{tokenAddress}/security.

GraphQL

Join Tokens with Trades, Holders, Candles in one query.

WebSocket

dex-token-stats:{chain}_{tokenAddress} for live price/volume, dex-new-token:{chain} for new listings. SDK: client.stream.subscribeTokenStats / subscribeNewToken.

Kafka

{chain}.tokens, {chain}.tokens.created topics per chain.

SDK

client.token.search(), client.token.getToken(), client.token.getTokenSecurity() in TS / Py / Go / Rust.

MCP / CLI

tokens_search, tokens_analyze MCP tools; chainstream token search / chainstream token info CLI.

​
Common use cases

  • Resolve a symbol like PEPE to the right address on the chain the user actually meant
  • Render a token page with price, supply, security score and socials
  • Detect new launches on a chain with a created-at filter
  • Rank tokens by volume, market cap or holder growth
  • Feed an LLM with a token “snapshot” for analysis

​
Billing

Each REST / GraphQL call consumes 1 read unit; security and full-meta endpoints may cost more. WebSocket and Kafka charge per message delivered. See Billing & units.

​
Next

Trades

Every DEX swap for this token, with maker/taker and router labels.

Holders

Distribution, concentration and top-holder movements.

Candles (OHLC)

Multi-interval OHLC data for price charts.

Token research tutorial

End-to-end example using the Tokens product.