Build on FOMO without talking to FOMO.

Quickstart

Private integrations receive { "success": true, "data": … }. Failures use HTTP status plus { "detail": "…" }.

curl -sS "https://fomo.1sav.xyz/status"
curl -sS "https://fomo.1sav.xyz/tokens?kind=trending"
curl -sS "https://fomo.1sav.xyz/tokens/search?q=SOL"
curl -sS "https://fomo.1sav.xyz/users/handle/alice"

const API = "https://fomo.1sav.xyz";

const res = await fetch(`${API}/tokens?kind=trending`);
const { success, data } = await res.json();
if (!success) throw new Error("FOMO API error");

// Scanner-compatible prefix also works:
await fetch(`${API}/api/fomo-scanner/me`);

import requests

API = "https://fomo.1sav.xyz"
status = requests.get(f"{API}/status").json()
tokens = requests.get(f"{API}/tokens", params={"kind": "trending"}).json()["data"]
user = requests.get(f"{API}/users/handle/alice").json()["data"]

Conventions

Chains

Token routes take a chain slug or numeric id. GET /status returns the live map.

Pagination

List endpoints that accept last_id, last_trade_id, or last_comment_id are cursor-style. Pass the last item’s id from the previous page.

CORS

Browser apps must be listed in this service’s CORS_ORIGINS. Same-origin calls from this docs page always work. Server-side callers have no CORS constraint.

Limits you will hit

• Watch: max 25 accounts and 15 tokens on this process.
• Referrals and referrer details only return for the logged-in session user.
• Upstream FOMO / Cloudflare can return 403/502/504; this API forwards a useful detail.

Recipes

1. Resolve a token, then load the page

GET /tokens/search?q=SOL
GET /tokens/lookup?q=So11111111111111111111111111111111111111112
GET /tokens/solana/So11111111111111111111111111111111111111112
GET /tokens/solana/So11111111111111111111111111111111111111112/warnings
GET /tokens/solana/So11111111111111111111111111111111111111112/holders

Search matches a phrase. Lookup is for a mint / contract. Details, warnings, holders, devs, friends, feed, and bars all use /tokens/{chain}/{address}.

2. Chart a token

GET /tokens/solana/So11111111111111111111111111111111111111112/bars?resolution=60&count_back=300

resolution is TradingView-style minutes (1, 5, 15, 60, 240, 1D). The service turns address + chain into FOMO’s address:networkId symbol.

3. Profile a trader

GET /users/search?q=alice
GET /users/handle/alice
GET /users/{userId}/trades
GET /users/{userId}/pnl?window=7d
GET /users/{userId}/rank
GET /users/{userId}/balances

4. Stream theses

const ws = new WebSocket("wss://fomo.1sav.xyz/watch/ws");
ws.onopen = () => {
  ws.send(JSON.stringify({
    action: "add",
    handle: "alice",
    watchTheses: true,
  }));
  ws.send(JSON.stringify({ action: "start" }));
};
ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.type === "event" && !msg.backfill) console.log(msg.kind, msg.handle, msg.token);
};

5. Post a thesis as the session user

GET /me
GET /users/{myUserId}/trades?token_address=DezX…
POST /trades/{tradeId}/thesis
{ "comment": "still early" }

# or let the service find your newest trade on that mint:
POST /thesis
{ "tokenAddress": "DezX…", "comment": "still early" }

A thesis is a comment on a FOMO trade UUID owned by the logged-in session. Transfers / “Received” fills often have no trade id — you need a FOMO-indexed buy or sell first. Posts as whoever GET /me returns.

Reference

Every path below is also available under /api/fomo-scanner.

Session

{
  "success": true,
  "data": {
    "configured": true,
    "expired": false,
    "seconds_left": 2800,
    "can_refresh": true,
    "auto_refresh": true,
    "api_base": "https://prod-api.fomo.family"
  },
  "chains": { "solana": 1399811149, "base": 8453 }
}

Tokens

{
  "success": true,
  "data": [{
    "priceUSD": "105.70",
    "marketCap": "60108380023",
    "volume24": "123945148",
    "token": {
      "address": "So11111111111111111111111111111111111111112",
      "networkId": 1399811149,
      "symbol": "SOL",
      "name": "Solana"
    }
  }]
}

Users & social

{
  "comment": "still early",
  "visibility": "public"
}

{
  "tokenAddress": "DezX…",
  "comment": "still early",
  "visibility": "public"
}

Account (FOMO-backed)

These read FOMO as the configured session. Some fields are public; referrals are session-only.

Watch WebSocket

This service polls FOMO REST (and a small market socket) and fans events out to your clients. Connect to wss://fomo.1sav.xyz/watch/ws (or ws://127.0.0.1:8990/watch/ws locally). The same commands work over HTTP if you do not want a socket.

Actions you send

Messages you receive

{
  "type": "event",
  "kind": "thesis",
  "source": "rest",
  "userId": "…",
  "handle": "alice",
  "token": "BONK",
  "address": "DezX…",
  "chain": "solana",
  "usd": 420.5,
  "thesis": "still early",
  "tradeId": "…",
  "fillId": "",
  "ts": "2026-04-12T16:01:00Z",
  "backfill": false
}

Account and token kind values on this socket are thesis, plus platform kinds verified, graduated, and pre_graduated. Buys, sells, and receives are not forwarded. Token-scoped events set scope: "token" and tokenKey. backfill: true means historical seed, not a live tick. Ignore backfill if you only want new activity.

Errors

{ "detail": "Unknown chain 'aptos'" }