Skip to content

Token

Pulse token page payload — one page-shaped response for a tracked token.

Free, no auth required. Cached for 5s. API key holders get higher rate limits.

Access

  • Anonymous: yes
  • Free API key: same endpoint, higher rate limits
  • Paid plans: same endpoint, highest rate limits
  • Rate limit bucket: Pulse reads

GET /v1/token/:mint

Get the Pulse summary for a token by symbol or mint.

Parameters:

  • :mint — Token symbol (SOL, JUP) or mint address

Query parameters:

  • topPools — Optional cap for the topPools array. Default 5, max 12.
  • include — Optional comma-separated enrichments. Today supports market to attach TVL / 24h volume from GeckoTerminal for returned pools.

Response:

json
{
  "token": {
    "symbol": "SOL",
    "mint": "So11111111111111111111111111111111111111112",
    "decimals": 9,
    "category": "native",
    "name": "Solana"
  },
  "summary": {
    "priceUsd": 176.24,
    "bestBid": 176.11,
    "bestAsk": 176.38,
    "change24h": 3.82,
    "live": true,
    "tradeable": true,
    "confidence": "confirmed",
    "cacheAgeMs": 180,
    "poolCount": 24,
    "route": "direct"
  },
  "bestVenue": {
    "bestBidPool": "...",
    "bestAskPool": "...",
    "bestBidDex": "orca-whirlpool",
    "bestAskDex": "raydium-clmm",
    "bestBidFeeBps": 1,
    "bestAskFeeBps": 1
  },
  "topPools": [],
  "links": {
    "pulse": "/token/SOL",
    "swap": "https://swap.venum.dev/?in=SOL"
  },
  "meta": {
    "servedAt": 1712000000000,
    "include": []
  }
}

This endpoint is optimized for first paint. It returns the fast Venum-native summary first and keeps heavier enrichments behind explicit flags.