$ 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_KEY2. 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"]