$ memescore docs --api
MemeScore API docs
The MemeScore API is a small HTTP interface for the same 0–100 Solana memecoin risk score you see on the website. Authenticate with an API key, call GET /v1/check?mint=…, and handle 429s using the rate-limit headers. It never asks for a wallet.
Machine-readable spec: /openapi.json. A compact overview for language models is at /llms.txt. There is no /v1/score route; the score endpoint is GET /v1/check.
How do I authenticate?
Paid plans that include API keys issue a key on your account page. The key is shown once and stored hashed. Send it as X-API-Key: ak_… or Authorization: Bearer ak_…. Keys use the prefix ak_test_ in test mode and ak_live_ in live mode. If a plan is downgraded to one with no API keys, existing keys stop working. The web free check and GET /v1/search do not use a key.
# authenticated check
curl -s "https://memescore.io/v1/check?mint=FdaduRjK4LAauRXrk2gLusE7jLLGxpgWCDJnqLT9pump" \
-H "X-API-Key: ak_live_••••••••••••••••"
What does GET /v1/check return?
This is the score endpoint. Pass a Solana token mint in ?mint= (base58, 32–44 characters). A successful response includes a 0–100 score, a verdict / level, four parts (safety, demand, smart, social), reasons and positives, plus market context such as liquidity, holders, and top-10 concentration. memescore_v1 is present when that mint is in the forward ledger; otherwise score_note explains that you are seeing the legacy v0 score. Cached responses are allowed and still count against your plan cap.
# response headers (example)
HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1794960000
X-RateLimit-Limit-Minute: 10
X-RateLimit-Remaining-Minute: 9
X-Cache: MISS
What other public endpoints exist?
GET /v1/search?q=— name or ticker lookup for the checker dropdown. Query must be 2–40 characters. This is unauthenticated, is not counted against check quotas, and is IP-throttled (about 120 searches per minute). Results are Solana tokens, highest liquidity first, with apossible_copycatflag when the name matches a larger coin.GET /v1/traders?mint=— wallets we track that traded this mint, ranked by follower result (paper copies over 30 days, after a delay and trading costs). Auth is optional: a session or API key unlocks the plan’s trader cap; anonymous callers see the free-plan cap (currently 3). Fast-flipper wallets are flagged. Not financial advice.GET /v1/feed— live graduation feed, on plans that includefeed. Requires a session or API key. Returns 403 if the plan does not include the feed.GET /v1/usage— remaining daily and per-minute checks for the authenticated account (web and all keys share one cap).GET /v1/ledger?limit=— public forward ledger of timestamped scores (limit 1–300, default 100). No API key.GET /proof.json— public accuracy payload. Until the live forward test is graded and posted, treat figures as a back-test.GET /free/check?mint=— anonymous homepage check, limited per IP per UTC day. Same score payload as/v1/check, no key.GET /healthz— liveness,{"ok": true}.
# name search (no key) curl -s "https://memescore.io/v1/search?q=bonk" # traders on a mint curl -s "https://memescore.io/v1/traders?mint=FdaduRjK4LAauRXrk2gLusE7jLLGxpgWCDJnqLT9pump" \ -H "Authorization: Bearer ak_live_••••••••••••••••" # remaining quota curl -s "https://memescore.io/v1/usage" -H "X-API-Key: ak_live_••••••••••••••••"
What are the rate limits per plan?
Checks per account are shared across the website and every API key. Cached hits still count. Limits reset at 00:00 UTC. Current offered plans:
- Free ($0): 20 checks/day with an account (5/min); no API keys.
- Trader ($29/mo): 100 checks/day, 10/min.
- API ($199/mo): 1500 checks/day, 60/min, up to 5 API keys, live graduation feed.
- Enterprise ($499/mo): 12000 checks/day, 200/min, up to 20 API keys, live graduation feed.
If this list and the pricing section ever disagree, the homepage is the offer. Search and trader endpoints have separate IP throttles, described above.
What error codes should I handle?
400— malformed mint or search query.401— missing or invalid API key (or not signed in, for session-only routes).403— authenticated, but the plan does not include that feature (for example/v1/feed).429— plan or IP rate limit. ReadRetry-Afterand theX-RateLimit-*headers.503— upstream busy, daily capacity reached, or a dependency is down. Retry later.
The service never asks for a wallet, never trades, and never holds funds. A score is analytics, not financial advice. See how the score is built and the FAQ.