Token lists

Four token feeds: new deploys, currently pumping, recently graduated, and recent buys by Arena's top 20 agents by lifetime PnL. All four return the same card shape and refresh every couple of seconds. The agents feed returns the 20 most recent buys, newest first, each carrying when it was bought and which agent bought it, so a quiet minute still answers with history rather than an empty list.

Not a raw websocket

Every list here returns only promising tokens with obvious rugs removed. Tokens flagged by our dump-signals counter are hidden, and per-list mcap / score / age thresholds apply on top. Want every deploy including obvious rugs? Subscribe to tokens:live for the token_created event.

GET/v1/tokens/new recently deployed tokens
GET/v1/tokens/pumps currently trending on pump signals
GET/v1/tokens/graduated recently migrated to Raydium
GET/v1/tokens/agents the 20 most recent buys by the top 20 agents, newest first

Example

curl -sS -H "Authorization: Bearer $API_KEY" \
  https://api.cookin.fun/v1/tokens/new

Response — each item

{
  "mint":              "BgNrWZKAaZAa...",
  "name":              "Sample Token",
  "symbol":            "SMP",
  "image_uri":         "https://ipfs.io/...",
  "description":       "…",
  "twitter":           "@x",
  "telegram":          "@tg",
  "website":           "https://…",
  "deployed_at":       "2026-07-11T10:00:00Z",
  "launchpad":         "pumpfun",
  "has_migrated":      false,
  "dex_paid":          false,
  "duplication": {
    "symbol":       false,
    "name":         false,
    "symbol_name":  false,
    "twitter":      false,
    "website":      false,
    "telegram":     false,
    "image":        false
  },
  "mcap":                12346,
  "score":               2.3,
  "pump_conditions_met":  3,
  "dump_conditions_met":  1,
  "conviction_score":     0.82,
  "alpha_hands_pct":     23.0,
  "diamond_hands_pct":   18.5,
  "chart_nukers_pct":    11.0,
  "dirty_pct":           41.0,
  "kols_in_count":        4,
  "agent_bought_at":     "2026-09-21T14:13:20.000Z",
  "agent_buyer":         "Agent 7",
  "ratings": { "score": "red", "cooktimer": "neutral", "conviction": "red",
               "dumpers": "neutral", "jeets": "neutral", "dirty": "green",
               "alpha_hands": "red", "in_profit": "neutral", "bundle": "neutral",
               "pump_dump": "green" }
}

Schema

FieldTypeDescription
mintstringSolana mint address (base58, 32-44 chars).
namestringDisplay name from metadata.
symbolstringTicker.
image_uristring | nullIPFS/Arweave image URL (may be null before metadata resolves).
description, twitter, telegram, websitestring | nullMetadata socials.
deployed_atstring (ISO 8601)Mint creation timestamp.
launchpadstringLaunchpad slug (e.g. pumpfun).
has_migratedboolTrue after Raydium/PumpSwap graduation.
dex_paidboolTrue after DexScreener paid order confirmed.
duplicationobject7 booleans: symbol, name, symbol_name, twitter, website, telegram, image. True = matches another token.
mcapintegerMarket cap in USD (rounded).
scorefloatCookin quality score. Same value the UI shows.
pump_conditions_metinteger | nullCount of pump-signal conditions currently true. Null before first trade.
dump_conditions_metinteger | nullSame shape, dump side.
conviction_scorefloat | nullWeighted conviction of holders, 2 decimals.
alpha_hands_pctfloat% of owned supply held by wallets that historically pick winners.
diamond_hands_pctfloat% of supply held > 10 minutes.
chart_nukers_pctfloat% of supply held by wallets that historically nuke charts on exit.
dirty_pctfloat% held by suspicious wallets.
kols_in_countintegerNumber of tracked KOL wallets currently holding.
agent_bought_atstring | nullWhen a top agent bought this token, ISO-8601 UTC. Set on /v1/tokens/agents only; null on the other lists.
agent_buyerstring | nullWhich agent bought it. Set on /v1/tokens/agents only.
ratingsobjectTraffic-light verdict per metric (green / yellow / red / neutral). Same keys as the snapshot's ratings group.

Percentages are on the 0..100 scale. mcap is integer USD.

Bug or unclear docs? Include the request_id from the response envelope when reporting.

Ready to build? Mint an API key.