cookin-fun
Python SDK for the Cookin API — real-time Pump.fun and Solana memecoin data. REST + WebSocket over the same pipeline that powers the cookin.fun UI. Quality scores, bundle detection, trader behavioral stats, live trade frames.
- Pro: 1 SOL per 30 days, 600 requests per minute, both WebSocket channels. Mint a key at cookin.fun/account/api-keys.
- No key? Pay per call in USDC on Solana with x402, from $0.01, or use the MCP server:
npx -y @cookinfun/mcp. - Docs: https://cookin.fun/api
- Discord: https://cookin.fun/discord
Install
pip install cookin-fun
Python 3.9+.
Quickstart
Mint an API key at cookin.fun/account/api-keys and set it as COOKIN_API_KEY.
from cookin_fun import Cookin
import os
cookin = Cookin(api_key=os.environ["COOKIN_API_KEY"])
# Full snapshot for one token
snap = cookin.tokens.get("BgNrWZKAaZAa...")
print(snap["data"]["score"]["value"], snap["data"]["holders"]["count"])
That's it. Every REST method returns the raw envelope dict {"data": ..., "meta": ...}. TypedDict definitions ship with the package so IDEs get autocomplete for every field.
REST
Every REST method returns the envelope as a plain dict. Field types are documented via TypedDicts in cookin_fun.types.
# Token feeds. All four return a list of token cards.
cookin.tokens.new() # recently deployed
cookin.tokens.pumps() # currently pumping
cookin.tokens.graduated() # recently on Raydium / PumpSwap
cookin.tokens.agents() # the 20 most recent buys by the top Cookin agents
# One token, one call. Filter to the field groups you actually need.
cookin.tokens.get(mint, fields=["meta", "market", "score", "ratings"])
# Most recent trades for a token, enriched with per-trade trader context.
cookin.tokens.trades(mint)
# Full behavioral profile for a wallet.
cookin.traders.get(wallet_address)
WebSocket
Two channels, both multiplexed on one socket connection. Use .on_tokens / .on_frames to register handlers, then .run_forever() to pump events.
socket = cookin.connect()
# Token lifecycle events: created, graduated, DEX-paid, metadata,
# duplication flags flipped.
def on_token_event(event):
if event["type"] == "token_created":
card = event["data"]
print("new token:", card["symbol"], card["score"])
# Every enriched trade, ~1s off Solana block time. One message per
# {signature, mint} unit, so multi-hop swaps arrive grouped.
def on_frame(frame):
for trade in frame["trades"]:
print(trade["signature"], trade["user_address"], trade["sol_amount"])
with socket:
socket.on_tokens(on_token_event)
socket.on_frames(on_frame)
socket.run_forever()
The SDK handles the Phoenix Channels v2 wire protocol (join, heartbeat, event dispatch) internally. Reconnect and back-pressure are left to callers on purpose so the SDK stays predictable. Wrap .connect() in your own reconnect loop for long-lived processes.
Examples
Two runnable scripts in examples/:
lifecycle_events.py— subscribes totokens:liveand prints one line per event type (token_created,token_metadata_retrieved,token_graduated,token_dex_paid,token_duplication_status_updated).wallet_watcher.py— streamsframes:livefiltered to a list of wallets.
COOKIN_API_KEY=sk_live_... python examples/lifecycle_events.py
Errors
Non-2xx responses raise a typed CookinError:
from cookin_fun import CookinError
try:
cookin.tokens.get(mint)
except CookinError as exc:
print(exc.status, exc.code, exc.request_id)
Every response carries a request_id in meta (and on errors, on the exception). Quote it when reporting issues.
Rate limits
60 requests per minute per key. X-RateLimit-* headers on every response. See Rate limits for details.
Full reference
Every endpoint, every field, every WebSocket event: cookin.fun/api.
Contributing
Bug reports and feature requests: Discord.
License
MIT
Ratings
Every card and snapshot carries ratings: a green, yellow,
red or neutral verdict per metric, using the same thresholds the
Cookin UI colours with. Gate on those instead of interpreting each
number.
snapshot = cookin.tokens.get(mint, fields=["ratings"])["data"]
if snapshot["ratings"]["bundle"] == "red":
return # coordinated supply
# Every token one deployer launched, with bond rate and peak market caps.
cookin.devs.tokens(deployer_address, limit=20)
neutral means the metric has no reading yet, which is normal in a
token's first seconds. It is not a pass.
Changelog
0.2.0
tokens.agents()replacestokens.survivors(). The survivors route was removed from the API; callingsurvivors()now raises a clear error instead of returning a 404 at runtime.devs.tokens(address, limit=..., offset=...)for a deployer's launch history.ratingson every card and snapshot, andagent_bought_at/agent_buyeron cards from the agents feed.- README corrected: the API is paid (Pro, or per call with x402), not free during beta.
Metadata
Release files for cookin-fun 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cookin_fun-0.2.0.tar.gz | 12.4 kB | Without provenance | Details for cookin_fun-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cookin_fun-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for cookin_fun-0.2.0-py3-none-any.whl |
Total release size: 25.6 kB
Release files / cookin_fun-0.2.0.tar.gz
| Download URL | cookin_fun-0.2.0.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0330458d3d4b03b29f07cab59ad3c9a981cdbefe03dc70aad9c3514b46a96e7
|
|
BLAKE2b-256 checksum How to use checksums |
a8f738fd43c19d9d3b57e50b7a234b2afcaae5d0fddbe30b3e3980043e781e3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / cookin_fun-0.2.0-py3-none-any.whl
| Download URL | cookin_fun-0.2.0-py3-none-any.whl |
|---|---|
| Size | 13.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e6536d8a944ab98dd69cc0840f595dd407447c587bae3315223643a975cb8c6
|
|
BLAKE2b-256 checksum How to use checksums |
16ece56726ae7b135bb8a9ae5b77ce59805e8ca6a10afb5b07202bd1ed743ae9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for cookin-fun 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.