$ memescore docs feed
GET /v1/feed — Live graduation feed
API docs
GET /v1/feed
Freshly graduated pump.fun coins and trending coins, already scored, so a bot can watch new launches without scoring each one itself.
- Auth: API key or a logged-in session. Plans with the feed: API, Enterprise.
- Quota: Counts 1 check per call. The feed is rebuilt at most every 60 seconds, so polling faster than that returns the same data.
Parameters
None.
Example request
curl
curl -s "https://memescore.io/v1/feed" \ -H "Authorization: Bearer ak_live_YOUR_KEY"
JavaScript (Node 18+ or Deno; server-side)
const res = await fetch("https://memescore.io/v1/feed",
{ headers: { Authorization: "Bearer " + process.env.MEMESCORE_KEY } });
if (res.status === 429) {
const wait = Number(res.headers.get("Retry-After") || 60);
// back off for `wait` seconds, then retry
}
const data = await res.json();
console.log(data);Python
import os, requests
r = requests.get(
"https://memescore.io/v1/feed",
headers={"Authorization": "Bearer " + os.environ["MEMESCORE_KEY"]},
timeout=20,
)
if r.status_code == 429:
print("retry after", r.headers.get("Retry-After"), "seconds")
else:
print(r.json())Example response
{
"generated": 1794961200,
"feed": [
{
"mint": "8vAcTdYBjEFZwQeC5TnJ8iaoaLz9TvFmmkZUEAJApump",
"symbol": "EXAMPLE",
"ts": 1794960802,
"mcap": 61000,
"liq": 18000,
"score": 27,
"parts": {
"safety": 45,
"demand": 30,
"smart": 0,
"social": 0
},
"holders": 412,
"verdict": "Caution",
"level": "caution",
"reasons": [
"Top 10 wallets hold 44% of supply"
],
"positives": [],
"smart": 0,
"smart_names": [],
"launch_min": 3,
"src": "Graduated"
}
],
"feed_counts": {
"clean": 3,
"caution": 9,
"rug": 14
}
}Shape is exact; the values are illustrative. Each item can contain: mint, symbol, ts, mcap, liq, score, parts, holders, verdict, level, reasons, positives, smart (count), smart_names, launch_min, src.
Response headers
HTTP/1.1 200 OK X-RateLimit-Limit: 1500 X-RateLimit-Remaining: 1499 X-RateLimit-Reset: 1795046400 X-RateLimit-Limit-Minute: 60 X-RateLimit-Remaining-Minute: 59 X-Cache: MISS
See rate limits.
Errors
| Status | When |
|---|---|
401 | "Log in or send an API key." |
403 | "The feed is part of the API plan." |
429 | "Rate limit reached for your plan." |
503 | "Feed unavailable right now." |