Live memecoin data, one token at a time or as a stream

curl https://api.trenchtick.com/v1/tokens/GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump \
  -H "X-API-Key: $TRENCHTICK_KEY"

const res = await fetch(
  "https://api.trenchtick.com/v1/tokens/GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump",
  { headers: { "X-API-Key": process.env.TRENCHTICK_KEY } }
);
const token = await res.json();
console.log(token.symbol, token.market_cap_usd);

import os, requests

r = requests.get(
    "https://api.trenchtick.com/v1/tokens/GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump",
    headers={"X-API-Key": os.environ["TRENCHTICK_KEY"]},
)
token = r.json()
print(token["symbol"], token["market_cap_usd"])

const ws = new WebSocket("wss://stream.trenchtick.com/v1/ws?api_key=" + KEY);
ws.onopen = () => ws.send(JSON.stringify({
  op: "subscribe",
  tokens: [{ chain: "sol", address: "GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump" }],
}));
ws.onmessage = (e) => {
  const { type, data } = JSON.parse(e.data);
  if (type === "snapshots" || type === "updates") console.log(type, data.length);
};

X-API-Key: tt_3f9a…
# or
Authorization: Bearer tt_3f9a…

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 27

# when limited
HTTP/1.1 429 Too Many Requests
Retry-After: 1

{
  "error": {
    "code": "rate_limited",
    "message": "slow down"
  }
}

curl https://api.trenchtick.com/v1/tokens/0xc53d0011343b467b36c8fa25df0ae93062e17777 \
  -H "X-API-Key: $TRENCHTICK_KEY"

const token = await fetch(
  `https://api.trenchtick.com/v1/tokens/${address}`,
  { headers: { "X-API-Key": KEY } }
).then((r) => r.json());

token = requests.get(
    f"https://api.trenchtick.com/v1/tokens/{address}",
    headers={"X-API-Key": KEY},
).json()

{
  "chain": "bsc",
  "address": "0xc53d0011343b467b36c8fa25df0ae93062e17777",
  "symbol": "玄学蛙",
  "launchpad": "flap",
  "pool_address": "0x02c85aa9f03b22c7f5c8d7815a1b2cd4160256c2",
  "price_usd": 0.0000027949963,
  "liquidity_usd": 5086.92,
  "market_cap_usd": 2794.99,
  "holders": 93,
  "top10_pct": 7.93,
  "dev_status": "sold_all",
  "sell_tax_pct": 1.0,
  "open_source": true,
  "honeypot": false
  // … every Token field we have
}

curl https://api.trenchtick.com/v1/tokens/sol/GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump \
  -H "X-API-Key: $TRENCHTICK_KEY"

const token = await fetch(
  `https://api.trenchtick.com/v1/tokens/${chain}/${address}`,
  { headers: { "X-API-Key": KEY } }
).then((r) => r.json());

token = requests.get(
    f"https://api.trenchtick.com/v1/tokens/{chain}/{address}",
    headers={"X-API-Key": KEY},
).json()

{
  "chain": "sol",
  "address": "GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump",
  "name": "Jean Phil", "symbol": "JEANPHIL", "decimals": 6,
  "socials": { "twitter": "https://x.com/JeanPhilMadame" },
  "created_at": 1789841756,
  "launchpad": "pump", "launchpad_name": "Pump.fun",
  "bonding_curve_pct": 100, "graduated": true,
  "dex": "meteora_dlmm", "quote_symbol": "SOL",
  "price_usd": 0.0018272455,
  "liquidity_usd": 258966.14,
  "market_cap_usd": 1771476.17,
  "fdv_usd": 1771476.17,
  "ath_market_cap_usd": 11589556,
  "price_change_1h_pct": -1.09,
  "volume_1h_usd": 14767.49, "buys_1h": 75, "sells_1h": 52,
  "holders": 16488,
  "top10_pct": 12.21, "dev_pct": 1.4063,
  "snipers_pct": 1.4063, "bundlers_pct": 19.16,
  "fresh_wallets_pct": 5, "bots_pct": 29.24,
  "dev_status": "holding",
  "mint_renounced": true, "freeze_renounced": true,
  "lp_burned_pct": 100, "honeypot": false,
  "buy_tax_pct": 0, "sell_tax_pct": 0,
  "dex_paid": true, "cto": false
}

curl https://api.trenchtick.com/v1/tokens/batch \
  -H "X-API-Key: $TRENCHTICK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tokens":[
        {"chain":"sol","address":"GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump"},
        {"address":"0xc53d0011343b467b36c8fa25df0ae93062e17777"}
      ]}'

const { tokens, missing, failed } = await fetch("https://api.trenchtick.com/v1/tokens/batch", {
  method: "POST",
  headers: { "X-API-Key": KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ tokens: watchlist.slice(0, 10) }),
}).then((r) => r.json());

data = requests.post(
    "https://api.trenchtick.com/v1/tokens/batch",
    headers={"X-API-Key": KEY},
    json={"tokens": watchlist[:10]},
).json()

{
  "tokens": [
    { "chain": "sol", "address": "GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump",
      "symbol": "JEANPHIL", "market_cap_usd": 1771476.17, … full Token … },
    { "chain": "bsc", "address": "0xc53d0011343b467b36c8fa25df0ae93062e17777",
      "symbol": "玄学蛙", "market_cap_usd": 2794.99, … full Token … }
  ],
  "missing": [],
  "failed": []
}

{
  "name": "acme",
  "plan": "trial",
  "expires_at": 1792200000,
  "limits": { "rps": 3, "burst": 3, "ws_connections": 2, "ws_subscriptions": null },
  "usage": { "requests": 1240, "limited": 3 }
}

{
  "chains": [
    { "id": "sol", "name": "Solana" },
    { "id": "bsc", "name": "BNB Chain" },
    …
  ]
}

import WebSocket from "ws";

const ws = new WebSocket("wss://stream.trenchtick.com/v1/ws", {
  headers: { "X-API-Key": process.env.TRENCHTICK_KEY },
});

import websockets

ws = await websockets.connect(
    "wss://stream.trenchtick.com/v1/ws",
    additional_headers={"X-API-Key": KEY},
)

{
  "op": "set",
  "tokens": [
    { "chain": "sol", "address": "GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump" },
    { "chain": "bsc", "address": "0xc53d0011343b467b36c8fa25df0ae93062e17777" }
  ],
  "id": 1
}

{ "type": "set",
  "data": { "id": 1, "added": 2, "removed": 0, "tokens": 2 },
  "ts": 1791012345678 }

{
  "type": "updates",
  "data": [
    { "chain": "sol", "address": "GTBxUiw6wJdmmkCGZgRHLyYxqu1vG4KtRpeox6yDpump",
      "price_usd": 0.0018301, "market_cap_usd": 1774254.9, "fdv_usd": 1774254.9 },
    { "chain": "bsc", "address": "0xc53d0011343b467b36c8fa25df0ae93062e17777",
      "holders": 94, "top10_pct": 7.81 }
  ],
  "ts": 1791012345678
}

type TokenUpdate = Partial<Token> & { chain: string; address: string };

type ServerMessage =
  | { type: "snapshots";     data: Token[] }         // replace each
  | { type: "updates";       data: TokenUpdate[] }   // merge each
  | { type: "set";           data: { id?: any; added: number; removed: number; tokens: number } }
  | { type: "subscribed";    data: { id?: any; added: number; tokens: number } }
  | { type: "unsubscribed";  data: { id?: any; removed: number } }
  | { type: "subscriptions"; data: { id?: any; subscriptions: { chain: string; address: string }[] } }
  | { type: "pong";          data: { id?: any } }
  | { type: "error";         data: { id?: any; code: string; message: string } };

type ClientMessage =
  | { op: "set" | "subscribe" | "unsubscribe"; tokens: { chain: string; address: string }[]; id?: any }
  | { op: "list"; id?: any }
  | { op: "ping"; id?: any };

async function rotate(oldWs) {
  const ws = open();                       // new socket
  await once(ws, "open");
  ws.send(JSON.stringify({ op: "set", tokens: WATCH, id: "rotate" }));
  await firstFrame(ws, "snapshots");    // new socket is live
  oldWs.close(1000);                      // then drop the old one
  return ws;
}

let attempt = 0;
function nextDelay() {
  const base = Math.min(30000, 1000 * 2 ** attempt++);
  return base / 2 + Math.random() * base / 2;  // jitter
}
// reset attempt = 0 after the first snapshots arrive