Pump.fun bundle detection API

Find out which wallets in a token are one person. Cookin groups wallets that trade together, tells you how much supply the group holds, and flags the groups that historically sell into their own chart.

Read the docs Pay per call, no account

What you get back

FieldMeaning
bundles.count Confirmed coordinated wallet groups holding this token.
bundles.red_count Of those, the groups that are heavy net sellers.
bundles.owned_pct_supply Share of supply the groups hold right now.
bundles.top_3_sizes_pct The three largest groups, by supply held.
ratings.bundle Green, yellow or red verdict, same thresholds as the Cookin UI.

One call

$ curl https://api.cookin.fun/v1/tokens/<mint>?fields=bundles,ratings \
    -H "Authorization: Bearer $COOKIN_API_KEY"

{
  "data": {
    "bundles": {
      "count": 4,
      "red_count": 2,
      "owned_pct_supply": 27.4,
      "top_3_sizes_pct": [14.1, 8.2, 3.7]
    },
    "ratings": { "bundle": "red", "dirty": "yellow", "score": "red" }
  }
}

Pay per call in USDC on Solana with x402, from $0.01 and no account, or use a Pro key at 1 SOL per 30 days. A call that errors is never charged. Full price list on the x402 page.

How it works

Wallets are grouped by how often they appear in the same token at the same time, and by shared funding. A group is confirmed once the evidence passes a fixed threshold, so a coincidence does not become a bundle. Every trade carries its group id too, so you can see a bundle buying in real time on the WebSocket feed.

Ways to call it

  • REST, with a Pro key or an x402 payment. See the endpoint docs.
  • MCP, for Claude, Cursor or any MCP client: remote at https://api.cookin.fun/mcp, or locally with npx -y @cookinfun/mcp.
  • SDKs for Node and Python.
  • WebSocket for live trades and new launches, included with Pro. See frames:live.

Questions

What counts as a bundle?

A set of wallets that repeatedly trade the same tokens together, or share a funding source. Cookin confirms a group only after enough co-occurrences, which keeps unrelated wallets out.

Does it work on a token that launched seconds ago?

Yes, and that is the point. Groups are detected from trading behaviour as it happens, not from a post-mortem. Early in a token's life the rating may be neutral, which means no reading yet rather than a pass.

Do I need an account?

No. Pay per call in USDC on Solana with x402, from $0.01, with no signup. A Pro key is cheaper past a few thousand calls a month.

Related