$ 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?

# 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:

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?

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.