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

Parameters

NameInRequiredDescription
qqueryyes2–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

StatusWhen
400"Type 2–40 characters."
429"Too many searches, slow down." (Retry-After: 30)
503"Search unavailable right now." (Retry-After: 30)