$ memescore docs check

GET /v1/check — Score a token

API docs
GET /v1/check?mint=…

The core call. Send a Solana mint address, get the 0–100 MemeScore, the verdict, the reasons behind it, and market context. This is the same check the website runs.

Parameters

NameInRequiredDescription
mintqueryyesSolana token mint address: base58, 32–44 characters.

Example request

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())

Example response

{
  "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "score": 20,
  "parts": {
    "safety": 0,
    "demand": 96,
    "smart": 0,
    "social": 0
  },
  "capped": true,
  "symbol": "Bonk",
  "name": "Bonk",
  "verdict": "Rug pattern",
  "level": "rug",
  "reasons": [
    "4 of 8 coins with editable metadata rugged",
    "Dev has launched 10 coins",
    "No X account or website"
  ],
  "positives": [
    "Real, organic buyers"
  ],
  "smart": [],
  "mcap": 210663457.31,
  "liq": 5723858.26,
  "holders": 1027386,
  "age_min": 1852273,
  "launchpad": null,
  "flags": [
    "mutable metadata"
  ],
  "top10": 36.54,
  "memescore_v1": null,
  "score_note": "Legacy v0 score: v1 currently covers pump.fun coins from graduation onward; coverage is expanding."
}

Real response for BONK (Nov 17, 2026), lightly rounded. Field meanings: response fields.

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
200Body has an error field: "We couldn't find this token. Check the address and try again." Neither RugCheck nor Jupiter knows the mint. This still counts as a check.
400"That doesn't look like a Solana token address." (mint missing or malformed)
401"Missing or invalid API key. Send Authorization: Bearer ak_…" Also returned if your plan no longer includes API keys.
429"Rate limit reached for your plan." plus plan. Retry-After is 60 for the minute cap, or the seconds until 00:00 UTC for the daily cap.
503"Busy, try again in a few seconds." (Retry-After: 5) or "Daily capacity reached. Try again tomorrow." (Retry-After: 3600).

Notes

Results are cached per mint for 60 seconds; X-Cache: HIT means you got the cached copy. If an upstream source fails, the result still returns and the matching rc_error, jup_error or smart_error field reads "upstream error".