$ memescore docs traders
GET /v1/traders — Tracked wallets that traded a coin
API docs
GET /v1/traders?mint=…
Who else is in this coin? Wallets we track that bought it, ranked by what a delayed paper copy of each wallet made over the last 30 days.
- Auth: Optional. Anonymous and Free callers see the top 5; paid plans see the full list.
- Quota: Not counted against check caps. Limited to 60 calls per minute per account (or per IP when anonymous).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
mint | query | yes | Solana token mint address. |
Example request
curl
curl -s "https://memescore.io/v1/traders?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \ -H "Authorization: Bearer ak_live_YOUR_KEY"
JavaScript (Node 18+ or Deno; server-side)
const res = await fetch("https://memescore.io/v1/traders?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/traders?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",
"plan": "api",
"total": 2,
"shown": 2,
"locked": 0,
"traders": [
{
"wallet": "7xKX\u2026example",
"first_buy_ts": 1794950000,
"status": "holding",
"follower_trades_30d": 41,
"follower_avg_return_pct": 12.4,
"follower_win_rate_pct": 46,
"median_hold_min": 95.0,
"flags": [],
"copy_links": {
"axiom": "https://axiom.trade/@memescore"
}
},
{
"wallet": "9wQe\u2026example",
"first_buy_ts": 1794950400,
"status": "exited",
"follower_trades_30d": 88,
"follower_avg_return_pct": -3.1,
"follower_win_rate_pct": 38,
"median_hold_min": 6.5,
"flags": [
"fast_flipper"
],
"copy_links": {
"axiom": "https://axiom.trade/@memescore"
}
}
],
"copy_terms": "If you show copy-trade or trading-platform buttons for these wallets, use the links in copy_links (see /terms section 5).",
"method": "Wallets we track that traded this coin. Follower numbers = our paper copies of each wallet over 30 days, bought after a delay with real trading costs. Not financial advice."
}Shape is exact; wallets and numbers are illustrative. fast_flipper = median hold under 15 minutes; those wallets sort last. locked = rows your plan doesn't show. Cached 2 minutes per mint. Copy-trade buttons: if your app shows "copy on Axiom" or similar buttons for these wallets, use the URL in copy_links as-is (required by the terms, section 5). Your users get 10% off Axiom fees through it.
Errors
| Status | When |
|---|---|
400 | "Send ?mint= |
429 | "Too many requests." (Retry-After: 30) |
503 | "Traders unavailable right now." |