cookie APIcookie.fun ↗
Access cookie.fun's AI agent/token leaderboard via API. Get mindshare, sentiment, market cap, token price, and rank data for top crypto AI agents.
What is the cookie API?
The cookie.fun API exposes one endpoint — get_leaderboard — that returns up to the full ranked list of crypto AI agent projects, each with 15+ fields covering Twitter mindshare, sentiment scores, market cap, token price, and historical deltas across six time windows. Developers can sort results by token price, market cap movement, or mindshare at any of seven lookback points, making it straightforward to build dashboards or alerting tools around AI agent token trends.
curl -X GET 'https://api.parse.bot/scraper/663d7a44-3e41-45eb-8e82-5afd759d88cd/get_leaderboard?limit=5&order_column=Name&order_data_point=Now' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cookie-fun-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.cookie.fun_api import CookieFun, Agent, OrderColumn, OrderDataPoint
client = CookieFun()
# List top agents by Twitter mindshare over the last 24 hours
for agent in client.agents.list(order_column=OrderColumn.TWITTER_MINDSHARE, order_data_point=OrderDataPoint.TWENTY_FOUR_HOURS_AGO):
print(agent.name, agent.symbol, agent.rank)
print(agent.mindshare.value, agent.mindshare.delta24h)
print(agent.market_cap.price, agent.market_cap.value)
print(agent.sentiment.value, agent.sentiment.delta7d)
Get AI agent/token leaderboard ordered by a chosen metric. Returns top crypto AI agents with sentiment, mindshare, and market data. Results are ordered descending by the chosen column and time period. Pagination is not supported; use limit to control result count. Each agent carries nested mindshare, sentiment, and market_cap objects with value/delta breakdowns.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return. |
| order_column | string | Column to order results by. |
| order_data_point | string | Time reference for ordering. |
{
"type": "object",
"fields": {
"items": "array of Agent objects with id, name, symbol, image, rank, mindshare, sentiment, market_cap"
},
"sample": {
"data": {
"items": [
{
"id": "kiboshib",
"name": "KiboShib",
"rank": 1,
"image": "https://coin-images.coingecko.com/coins/images/29335/large/foto_no_exif_%2811%29%282%29_%281%29.png?1696528285",
"symbol": "KIBSHI",
"mindshare": {
"chart": [],
"delta": 0,
"value": 0,
"delta7d": 0,
"delta24h": 0,
"delta30d": 0,
"delta90d": -0.0015
},
"sentiment": {
"chart": [],
"delta": 0,
"value": 0,
"delta7d": 0,
"delta24h": 0,
"delta30d": 0,
"delta90d": 0
},
"market_cap": {
"chart": [],
"delta": 0,
"price": 0.00000193,
"value": 1935712,
"delta7d": 0,
"delta24h": 0,
"isPreTge": false
}
}
]
},
"status": "success"
}
}About the cookie API
What the API Returns
The get_leaderboard endpoint returns a ranked list of crypto AI agent projects from cookie.fun. Each record includes a unique project id slug, name, current rank, CoinGecko image URL, and symbol. The three core metric objects — mindshare, sentiment, and market_cap — each carry a current value, a relative delta, and pre-computed deltas at 24-hour, 7-day, 30-day, and 90-day intervals, plus a chart array for sparkline rendering.
Sorting and Filtering
The order_column parameter controls which metric the leaderboard sorts by. Accepted values are Name, ProjectCreationDate, TokenPrice, TokenPriceDelta, and TokenMark (market cap). The order_data_point parameter selects the time reference for that sort: Now, _1HourAgo, _6HoursAgo, _12HoursAgo, _24HoursAgo, _3DaysAgo, or a weekly equivalent. Results are always returned in descending order. The limit parameter caps how many rows come back.
Market Data Fields
The market_cap object carries an isPreTge boolean indicating whether the token has not yet had its token generation event, which is relevant when the price and value fields may be zero or absent. The delta and delta24h sub-fields let callers detect tokens whose market cap is moving quickly over short windows without needing to store historical snapshots themselves.
The cookie API is a managed, monitored endpoint for cookie.fun — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cookie.fun changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cookie.fun API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track which AI agent tokens are gaining Twitter mindshare over the past 24 hours using
mindshare.delta24h - Build a price-momentum screener by sorting
get_leaderboardonTokenPriceDeltaat_24HoursAgo - Render a sparkline chart for each project using the
mindshare.chartormarket_cap.chartarrays - Flag pre-TGE projects using the
market_cap.isPreTgefield before routing them to a separate watchlist - Compare sentiment vs. mindshare divergence across top-ranked agents to identify narrative-price dislocations
- Pull the top-N agents by market cap at different time references to detect recent entrants climbing the leaderboard
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does cookie.fun have an official developer API?+
What does the `mindshare` object actually measure?+
mindshare object reflects each AI agent project's share of relevant Twitter/X discussion relative to other projects tracked by cookie.fun. It exposes a current value (a percentage or index score), a short-term delta, and pre-computed deltas at 24h, 7d, 30d, and 90d. A chart array is included for plotting trends over time.Can I retrieve historical leaderboard snapshots or data for a single project?+
Are there any quirks with pre-TGE token data?+
market_cap.isPreTge is true, the price and value fields inside the market_cap object may be zero or null because the token has not yet launched. Callers should check this flag before using price-derived fields in calculations or displays.