Token details

curl "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "Authorization: Bearer $API_KEY"

const response = await fetch(
  "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const token = await response.json();
console.log(token.symbol, token.price.usd);

{
  "chain": "solana",
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "name": "Bonk",
  "symbol": "Bonk",
  "decimals": 5,
  "price": { "native": "0.000000121", "usd": "0.0000216" },
  "marketCap": { "native": "10741962.1", "usd": "1917440000" },
  "liquidity": { "native": "61230.4", "usd": "10929626" },
  "stats": {
    "24h": {
      "priceChangePct": "-3.4",
      "volume": { "native": "301422.8", "usd": "53803970" },
      "buyCount": 48211,
      "sellCount": 45390,
      "buyVolume": { "native": "151002.1", "usd": "26953870" },
      "sellVolume": { "native": "150420.7", "usd": "26850100" }
    }
  },
  "holders": { "count": 972311, "top10Pct": "31.7", "sniperPct": "0.2" },
  "security": { "mintDisabled": true, "transferBlockable": false },
  "updatedAt": 1789632012345
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "No such token on this chain."
  }
}

GET

tokens

{chain}

{address}

curl "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "Authorization: Bearer $API_KEY"

const response = await fetch(
  "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const token = await response.json();
console.log(token.symbol, token.price.usd);

{
  "chain": "solana",
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "name": "Bonk",
  "symbol": "Bonk",
  "decimals": 5,
  "price": { "native": "0.000000121", "usd": "0.0000216" },
  "marketCap": { "native": "10741962.1", "usd": "1917440000" },
  "liquidity": { "native": "61230.4", "usd": "10929626" },
  "stats": {
    "24h": {
      "priceChangePct": "-3.4",
      "volume": { "native": "301422.8", "usd": "53803970" },
      "buyCount": 48211,
      "sellCount": 45390,
      "buyVolume": { "native": "151002.1", "usd": "26953870" },
      "sellVolume": { "native": "150420.7", "usd": "26850100" }
    }
  },
  "holders": { "count": 972311, "top10Pct": "31.7", "sniperPct": "0.2" },
  "security": { "mintDisabled": true, "transferBlockable": false },
  "updatedAt": 1789632012345
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "No such token on this chain."
  }
}

One token’s current state. chain is a chain slug, and address is in that chain’s own format. updatedAt says when the state was last refreshed.

Reading the response

Holder groups defines every field of holders, and wallet classifications defines the flags those groups count.
security.rugPct and metadata.twitterReuseCount read "0" and 0 on every token. Do not rely on them yet.
platforms and annotations are left out when they are empty. Today the only listing in platforms is a paid DexScreener profile.

Errors

Code	When
`UNSUPPORTED_CHAIN`	`chain` is not a supported slug
`VALIDATION_ERROR`	`address` is malformed, or not of the chain’s family
`NOT_FOUND`	No such token on this chain

Every endpoint also answers the universal errors.

curl "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "Authorization: Bearer $API_KEY"

const response = await fetch(
  "https://api.metastreams.io/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  { headers: { Authorization: `Bearer ${process.env.API_KEY}` } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const token = await response.json();
console.log(token.symbol, token.price.usd);

{
  "chain": "solana",
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "name": "Bonk",
  "symbol": "Bonk",
  "decimals": 5,
  "price": { "native": "0.000000121", "usd": "0.0000216" },
  "marketCap": { "native": "10741962.1", "usd": "1917440000" },
  "liquidity": { "native": "61230.4", "usd": "10929626" },
  "stats": {
    "24h": {
      "priceChangePct": "-3.4",
      "volume": { "native": "301422.8", "usd": "53803970" },
      "buyCount": 48211,
      "sellCount": 45390,
      "buyVolume": { "native": "151002.1", "usd": "26953870" },
      "sellVolume": { "native": "150420.7", "usd": "26850100" }
    }
  },
  "holders": { "count": 972311, "top10Pct": "31.7", "sniperPct": "0.2" },
  "security": { "mintDisabled": true, "transferBlockable": false },
  "updatedAt": 1789632012345
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "No such token on this chain."
  }
}

Authorizations

Authorization

string

header

required

Send the API key as Authorization: Bearer <key>.

Path Parameters

chain

enum<string>

required

Chain the resource lives on. Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.

Available options:

solana,

base,

bsc,

robinhood,

arc

address

string

required

Token mint or contract address.

Response

The token.

GET /v1/tokens/{chain}/{address} response.

address

string

required

Token address.

ath

object

required

All-time-high price and market cap.

Show child attributes

chain

enum<string>

required

Chain the token trades on.

Available options:

solana,

base,

bsc,

robinhood,

arc

createdAt

integer<int64>

required

Creation timestamp.

creator

string

required

Creator address.

decimals

integer<int32>

required

Token decimals.

Required range: x >= 0

devFunding

object

required

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

Show child attributes

dexes

string[]

required

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

Example:

["pumpswap", "raydium"]

holders

object

required

Holder-risk breakdown.

Show child attributes

liquidity

object

required

Current liquidity.

Show child attributes

marketCap

object

required

Current market cap.

Show child attributes

metadata

object

required

Off-chain project metadata.

Show child attributes

name

string

required

Token name.

price

object

required

Current price.

Show child attributes

security

object

required

On-chain security flags.

Show child attributes

stats

object

required

Trailing-window stats, one key per rolling window.

Show child attributes

supply

string<decimal>

required

Total supply.

Example:

"123.456789"

symbol

string

required

Token symbol.

totals

object

required

All-time volume and fee totals.

Show child attributes

updatedAt

integer<int64>

required

Last update timestamp.

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.

Option 1
Option 2
Option 3
Option 4

Show child attributes

Example:

[{ "kind": "mayhem_mode" }]

bondingCurvePct

null | string<decimal>

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

Example:

"123.456789"

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 doc gives the producer string its variant maps from.

Show child attributes

REST

Streams

Reading the response

Errors

Authorizations

Path Parameters

Response

​Reading the response

​Errors

Authorizations

Path Parameters

Response

Reading the response

Errors