$ 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.

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

StatusWhen
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."