$ memescore docs quickstart

Quickstart: your first MemeScore API call

API docs

1. Get an API key

API keys come with API (up to 5 keys) and Enterprise (up to 20 keys). Sign up (or upgrade from your account), then press New key on the account page. Copy it right away: we store only a hash, so it can't be shown again. Keys look like ak_live_ followed by 32 characters.

# keep it in an environment variable, never in code
export MEMESCORE_KEY=ak_live_YOUR_KEY

2. Score your first coin

curl

curl -s "https://memescore.io/v1/check?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"

JavaScript (Node 18+ or Deno; server-side)

const res = await fetch("https://memescore.io/v1/check?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  { 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/check?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    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())

3. Read the answer

Start with three fields: score (0–100, higher is better), level (clean, caution or rug) and reasons (plain-English red flags). If capped is true, a hard red flag zeroed the safety part. Everything else is in response fields.

# trimmed response
{
  "score": 20,
  "level": "rug",
  "verdict": "Rug pattern",
  "capped": true,
  "reasons": [
    "4 of 8 coins with editable metadata rugged",
    "Dev has launched 10 coins",
    "No X account or website"
  ],
  "positives": [
    "Real, organic buyers"
  ]
}

4. Stay inside your limits

Each counted response carries X-RateLimit-Remaining and X-RateLimit-Remaining-Minute. On a 429, wait Retry-After seconds. GET /v1/usage tells you what's left without spending a check. Details: rate limits.

5. A simple bot rule

A reasonable starting filter for an auto-buyer: skip anything with level == "rug" or capped == true, and treat caution as a smaller size or a manual look. That's a filter, not a strategy, and not financial advice.

# python
def should_skip(r):
    if r.get("error"):
        return True          # token not found
    return r["level"] == "rug" or r["capped"]