cookie.fun 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.
curl -X GET 'https://api.parse.bot/scraper/663d7a44-3e41-45eb-8e82-5afd759d88cd/get_leaderboard?limit=5&order_column=TwitterSentiment&order_data_point=_7DaysAgo' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return. |
| order_column | string | Column to order results by. Accepted values: Name, ProjectCreationDate, TokenPrice, TokenPriceDelta, TokenMarketCap, TokenMarketCapDelta, TokenHoldersCount, TokenHoldersCountDelta, TwitterFollowersCount, TwitterImpressionsCount, TwitterImpressionsCountDelta, TwitterEngagementsCount, TwitterEngagementsCountDelta, TwitterSmartEngagementPoints, TwitterSmartEngagementPointsDelta, TwitterMindshare, TwitterMindshareDelta, TwitterSmartFollowersCount, TwitterSmartFollowersCountDelta, SmartEngagementToMarketCapRatio, AverageImpressionsToMarketCapRatio, TwitterAverageImpressionsCount, TwitterAverageImpressionsCountDelta, TwitterAverageEngagementsCount, TwitterAverageEngagementsCountDelta, TokenHHIndex, TokenHHIndexDelta, TokenTheilIndex, TokenTheilIndexDelta, TokenLargestHolderPercent, TokenLargestHolderPercentDelta, TokenTop10HoldersPercent, TokenTop10HoldersPercentDelta, TokenTop50HoldersPercent, TokenTop50HoldersPercentDelta, TokenTop100HoldersPercent, TokenTop100HoldersPercentDelta, TokenWhalesCount, TokenWhalesCountDelta, TokenWeek1Retention, TokenWeek1RetentionDelta, TokenMonth1Retention, TokenMonth1RetentionDelta, ProjectAddedDate, MindshareToMarketCapRatio, TokenVolume24Hours, TokenVolume24HoursDelta, TokenLiquidity, TwitterMindshareInnerCircle, TwitterMindshareInnerCircleDelta, TwitterMentionsCount, TwitterMentionsCountDelta, TwitterSentiment, TwitterSentimentDeltaPercent, TwitterSentimentDeltaRaw. |
| order_data_point | string | Time reference for ordering. Accepted values: Now, _1HourAgo, _6HoursAgo, _12HoursAgo, _24HoursAgo, _3DaysAgo, _7DaysAgo, _14DaysAgo, _30DaysAgo, _90DaysAgo, Total. |
{
"type": "array",
"fields": {
"id": "string - Unique project identifier slug",
"name": "string - Full project name",
"rank": "integer - Position in leaderboard",
"image": "string - CoinGecko image URL",
"symbol": "string - Token ticker symbol",
"mindshare": "object - Twitter mindshare metrics with value, delta, delta24h, delta7d, delta30d, delta90d, chart",
"sentiment": "object - Sentiment metrics with value, delta, delta24h, delta7d, delta30d, delta90d, chart",
"market_cap": "object - Market data with isPreTge, value, price, delta, delta24h, delta7d, chart"
},
"sample": {
"data": [
{
"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.00128
},
"sentiment": {
"chart": [],
"delta": 0,
"value": 0,
"delta7d": 0,
"delta24h": 0,
"delta30d": 0,
"delta90d": 0
},
"market_cap": {
"chart": [],
"delta": 0,
"price": 0.00000411,
"value": 4112588,
"delta7d": 0,
"delta24h": 0,
"isPreTge": false
}
}
],
"status": "success"
}
}About the cookie.fun 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.
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.
- 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 | 250 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.