$ 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.
- Auth: API key, required (Bearer or X-API-Key). A browser session is not accepted here.
- Quota: Counts 1 check against your plan's daily and per-minute caps, including cached hits.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
mint | query | yes | Solana 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
| Status | When |
|---|---|
200 | Body 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".