experiencing high traffic — performance might be degraded
FomoScan · Docs

Get started with the FomoScan API.

FomoScan connects fomo.family wallets to the people behind them: give it a handle and get the wallets that person controls, give it a wallet and get the person behind it. This page gets your first call working, and the full endpoint reference covers every route. For exact request and response shapes, open the interactive Swagger UI (opens in a new tab) or fetch the OpenAPI 3.1 document at GET /openapi.json.

Quickstart

  1. Sign up at the partner portal (opens in a new tab) and hold a key in a minute.
  2. Send it as a bearer token on every request: Authorization: Bearer $KEY.
  3. Read the response from the envelope's `data` field, and check `meta.asOf` for freshness.
Example requestcurl
curl -s -H "Authorization: Bearer $FOMOSCAN_KEY" \
  "https://api.fomoscan.sh/v2/user/handle/tradername"
Response200 OK
{
  "data": {
    "id": "193fb089-854e-5152-94f5-f55dd86e2900",
    "handle": "tradername",
    "name": "Frank",
    "solanaAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "evmAddress": null
  },
  "meta": { "asOf": "2026-08-19T10:00:00.000Z", "requestId": "…" }
}

What you can build

  • 01

    Identity

    Resolve a fomo.family handle to its verified wallets, and a wallet back to the handle behind it. Every match is proof-verified, never inferred.

    See endpoints →
  • 02

    Theses

    A trader's written rationale attached to a token — pollable, newest first, by token or by author.

    See endpoints →
  • 03

    Live feed

    A WebSocket that pushes every new thesis as it is indexed, filtered to a token list or the whole firehose.

    See endpoints →

Common questions

How do I authenticate with the FomoScan API?

Send your key as a bearer token: Authorization: Bearer $KEY. X-Api-Key: $KEY works as an alternative. Production keys start with fsk_live_, sandbox keys with fsk_test_.

Where do I get a FomoScan API key?

Sign up at the partner portal and hold a key within a minute — every plan reaches every endpoint, so there is no feature gating to navigate first.

What is the difference between this guide and the Swagger docs?

This guide and the full reference at /api/docs explain how the API behaves: error semantics, rate limits, what a miss means. The interactive Swagger UI at api.fomoscan.sh/docs is generated from the running service: it lists exact request and response shapes and lets you call an endpoint live with your key. The OpenAPI 3.1 document is at api.fomoscan.sh/openapi.json.

Does the FomoScan API have a free tier?

Yes. Explore gives every account with a verified email a one-time credit grant, with no card. Plans and current rates are published at partner.fomoscan.sh.

Go deeper

Every endpoint, its error codes and its rate limits live in the full reference.