Skip to main content
GET
Returns the current state of each token in tokens, a comma-separated list of 1 to 100 addresses. chains limits the read to a comma-separated list of chain slugs. Omit it to read every chain. updatedAt is the time a token’s state was last refreshed.

Response

The response is a list with one token object per chain that holds each requested token, in the order of the request. An address reads on every chain in scope of its format, so an EVM address can return one object for each EVM chain that holds it. Each object carries its own chain and address. A token that no chain in scope holds has no object, so the response can be an empty list. It is not a 404.

Response fields

  • Holder groups defines every field of holders, and wallet classifications defines the flags those groups count.
  • security.rugPct and metadata.twitterReuseCount are "0" and 0 on every token and should not be relied on yet.
  • platforms and annotations are omitted when empty. Currently, the only listing in platforms is a paid DexScreener profile.

Errors

Every endpoint can also return the universal errors.

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

tokens
string
required

Token addresses, CSV; one to 100. Each reads on every chain in scope of its address family.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

Response

One token per chain each named address trades on, in the order the request named them.

address
string
required

Token address.

ath
object
required

All-time-high price and market cap.

chain
enum<string>
required

Chain the token trades on.

Available options:
solana,
bsc,
robinhood,
elysium,
ethereum
createdAt
integer<int64>
required

Creation timestamp.

creator
string
required

Creator address.

devFunding
object
required

The creator wallet's first inbound funding. Always present; its status says whether the lookup has settled.

dexes
string[]
required

Venues the token's top pools trade on, deepest first.

Example:
holders
object
required

Holder-risk breakdown.

liquidity
object
required

Current liquidity.

Token artwork on the CDN.

marketCap
object
required

Current market cap.

metadata
object
required

Off-chain project metadata.

name
string
required

Token name.

price
object
required

Current price.

security
object
required

On-chain security flags.

stats
object
required

Trailing-window stats, one key per rolling window.

symbol
string
required

Token symbol.

totals
object
required

All-time volume and fee totals.

updatedAt
integer<int64>
required

Last update timestamp.

decimals
integer<int32>
required

Token decimals.

Required range: x >= 0
supply
string<decimal>
required

Total supply.

Example:

"123.456789"

anchorAddress
string | null

Address of the quote asset in the token's deepest pool; null where it is not known.

anchorSymbol
string | null

Display symbol of that quote asset, on anchorAddress's terms.

annotations
object[]

Platform-scoped quirk flags the launch carried.

A platform-scoped flag the launch carried, tagged by kind.

Example:
bondingCurvePct
null | string<decimal>

Bonding-curve completion, 0-100; null off launchpad curves.

Example:

"123.456789"

fees
null | object

What a trade costs here and where the tax goes; absent where no source states either.

graduatedAt
null | integer<int64>

When the token graduated off its launchpad; null until graduation.

graduatedToDex
string | null

Venue the graduation pool trades on; null until graduation.

graduatedToPool
string | null

Pool the launchpad pool migrated into; null until graduation.

launchpad
string | null

Launchpad the token launched through; null for non-launchpad tokens.

platforms
object[]

The token's external-platform listings.

A platform attached to a token, a wallet, or a trade.

The fieldless variants are trading terminals, each described by its display name.

pools
object[]

The token's top pools by liquidity, deepest first.