Quickstart

Create an account

Sign up at partner.fomoscan.sh/signup with Google or an email address, then confirm the code we email you. Verifying the email activates your free credits. A v2 key works on v3, so skip to step 3 if you have one.

Generate your API key

On the dashboard, select Generate your API key. Copy it right away: the portal shows the full key once. Keys look like fsk_live_….

Find a trader

export KEY=fsk_live_...
curl -s -H "Authorization: Bearer $KEY" \
  "https://api.fomoscan.sh/v3/traders/lookup?handle=frankdegods"

The answer is a page of traders. Each one is an envelope, trimmed here:

{
  "items": [
    {
      "kind": "trader",
      "id": "tdr_01m5qhae6sf5v91189b6sejnzq",
      "canonical": {
        "display": { "handle": "frankdegods", "name": "frank", "avatarUrl": "…" },
        "platforms": ["fomo", "hyperliquid"],
        "walletAvailable": true
      },
      "sources": {
        "fomo": {
          "profile": { "handle": "frankdegods", "xHandle": "frankdegods", "observedAt": "…" },
          "followGraph": { "followers": 396600, "following": 331, "observedAt": "…" }
        }
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "match": "exact"
}

Store the id. Every other trader call takes it, and it stays the same when the trader renames. Objects and ids explains the shape.

A lookup costs 100 credits when it finds a trader and 200 when it does not. Answers that show who owns a wallet or what a trader earned take a reveal. A key on a free plan without reveals gets 403 PERMISSION_DENIED for them until you pick a plan. canonical.walletAvailable says, without a reveal, whether the trader’s wallets will come back.

Check your balance

GET /v3/me is free and returns your plan, the credits and reveals left this month, and your rate limit. v2 and v3 spend from the same balance.

curl -s -H "Authorization: Bearer $KEY" "https://api.fomoscan.sh/v3/me"

When the free credits run out, pick a plan or buy a credit pack in the portal. See Credits and pricing.

Traders, wallets and PnL

From a handle to wallets and profit.

Posts

Calls and positions, per trader and per token.

Live posts

Every new post on one socket.

Get started

Core concepts

Moving from v2

Next

Traders, wallets and PnL

Posts

Live posts

​Next

Traders, wallets and PnL

Posts

Live posts

Next