$ memescore docs search
GET /v1/search — Search tokens by name or ticker
API docs
GET /v1/search?q=…
Turn "bonk" into the right mint address. Solana results only, highest liquidity first, with a flag when a smaller coin copies a bigger coin's name.
- Auth: None.
- Quota: Free and not counted. Limited to about 120 searches per minute per IP.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
q | query | yes | 2–40 characters. A leading $ is fine. |
Example request
curl
curl -s "https://memescore.io/v1/search?q=bonk"
JavaScript (Node 18+ or Deno; server-side)
const res = await fetch("https://memescore.io/v1/search?q=bonk");
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/search?q=bonk",
timeout=20,
)
if r.status_code == 429:
print("retry after", r.headers.get("Retry-After"), "seconds")
else:
print(r.json())Example response
{
"q": "bonk",
"results": [
{
"mint": "BonkUg9t46HnxF4erZzmnB4Ae6oEcDS4V66zqUoUhwWY",
"symbol": "Bonk",
"name": "Bonk",
"liquidity_usd": 1705466,
"mcap_usd": 3279727,
"created_ts": 1773402195,
"dex": "raydium",
"pump_fun": false,
"possible_copycat": false
},
{
"mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "Bonk",
"name": "Bonk",
"liquidity_usd": 236780,
"mcap_usd": 210398463,
"created_ts": 1671980424,
"dex": "orca",
"pump_fun": false,
"possible_copycat": true
}
]
}Up to 25 results, one row per mint (its deepest pool). Data comes from DexScreener and is cached 5 minutes per query. possible_copycat is a name match against the most liquid same-name coin, not proof; always confirm the mint.
Errors
| Status | When |
|---|---|
400 | "Type 2–40 characters." |
429 | "Too many searches, slow down." (Retry-After: 30) |
503 | "Search unavailable right now." (Retry-After: 30) |