Token snapshot

Everything Cookin tracks for a single mint, organized into nine field groups. Use ?fields=group1,group2 to return only the ones you need.

GET/v1/tokens/:mint full state snapshot for one token

Example

curl -sS -H "Authorization: Bearer $API_KEY" \
  "https://api.cookin.fun/v1/tokens/BgNrWZKAaZAa...?fields=meta,market,score"

Response — 9 groups

{
  "meta":    { "mint": "...", "name": "...", "symbol": "...", "deployed_at": "...", ... },
  "status":  { "has_migrated": false, "dex_paid": true, "is_og": true, "duplication": { ... } },
  "market":  { "mcap": 12346, "ath_mcap": 20000, "ath_slot": 123456 },
  "holders": { "count": 850, "top_3_pct": 15.5, "top_5_pct": 22.0, "top_10_pct": 33.3,
               "pct_supply_owned": 45.5,
               "top": [ {"address": "...", "pct_of_supply": 5.5}, ... ] },
  "bundles": { "count": 4, "red_count": 1, "owned_pct_supply": 8.25,
               "top_3_sizes_pct": [3.5, 2.0, 1.25] },
  "score":   { "value": 2.3, "smart_wallets_count": 3, "cooktimer_slots": 240,
               "conviction_score": 0.82,
               "dumpers_pct": 100.0, "jeets_pct": 100.0, "dirty_pct": 41.0,
               "alpha_hands_pct": 23.0, "in_profit_pct": 100.0, "bundle_pct": 8.25 },
  "cohorts": { "hold_duration_pct": { ... },
               "pnl_pct": { ... },
               "roi_pct": { ... },
               "sell_impact_pct": { ... },
               "buys_pct": { ... },
               "sol_balance_pct": { ... },
               "hcr_pct": { ... } },
  "kols":    { "count": 3, "list": [ { "wallet": "...", "user_name": "...", ... } ] },
  "signals": { "pump_conditions_met": 3, "dump_conditions_met": 1 }
}

Groups

Group	Contents
`meta`	identity + static metadata (mint, symbol, name, deployed_at, launchpad, image, description, socials).
`status`	lifecycle flags (`has_migrated`, `dex_paid`, `is_og`, per-field duplication flags).
`market`	`mcap` + `ath_mcap` (integer USD), `ath_slot`.
`holders`	`count`, top-3/5/10 concentration ratios, total `pct_supply_owned`, top 3 wallet addresses with their pct.
`bundles`	confirmed bundle `count`, red-flagged `red_count`, `owned_pct_supply`, top 3 bundle sizes.
`score`	headline `value` + all sub-metrics (`dumpers_pct`, `jeets_pct`, `dirty_pct`, `alpha_hands_pct`, `in_profit_pct`, `bundle_pct`) + `smart_wallets_count`, `cooktimer_slots`, `conviction_score`.
`cohorts`	7 bracket-distributions × 5 buckets each (hold duration, PnL, ROI, sell impact, past buys, SOL balance, healthy-coins rate).
`kols`	KOL wallets currently holding — `count` + `list` with pct_of_supply, expected sell slot, sell_impact per wallet.
`signals`	`pump_conditions_met` + `dump_conditions_met` (integer counts, null before first trade).

Field details

A few fields carry meaning that isn't obvious from the name. Reference for the ones that come up most often.

`status`

Field	Description
`is_og`	True when all five duplication signals (symbol+name, image, twitter, website, telegram) are false. Marks the token as an original rather than a copy of an earlier deploy.

`bundles`

Field	Description
`red_count`	Subset of `count` flagged as high-risk (bundles whose wallets are heavy net sellers). Quick "will this bundle likely dump the chart" signal.

`score`

Field	Description
`smart_wallets_count`	Number of wallets currently holding that are tagged as smart money.
`cooktimer_slots`	Rough estimate of how long the token has left before large exits start to happen.
`conviction_score`	Weighted conviction score across the current holder base. Higher means holders are less likely to sell soon.
`dumpers_pct`	Percent of owned supply held by wallets with a history of high-sell-impact selling (wallets that visibly move charts when they exit).
`jeets_pct`	Percent of owned supply held by wallets that historically sell quickly. Paper-hand exposure.
`dirty_pct`	Percent of owned supply held by wallets flagged as dirty (previously involved in suspicious or rug activity).
`alpha_hands_pct`	Average healthy-coins-rate across current holders. A wallet's healthy-coins-rate is the percentage of its 10-minute-old buys that are still in profit; a proxy for "these holders pick winners".
`in_profit_pct`	Percent of owned supply currently sitting in unrealized profit.
`bundle_pct`	Percent of owned supply held by wallets in confirmed bundles. Same denominator as the other `_pct` fields in this group.

Field selection

Add ?fields=meta,market,score to trim the response to just those groups. Unknown groups are dropped silently — adding a new group in a later version can't break your integration.

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

404 semantics

Returns 404 if the mint has never been observed by our ingest. That includes freshly-deployed tokens if you query within the first ~2 seconds. Retry with backoff if you know the mint is real.

Terms and Conditions