CopyFomo API

A read-only snapshot of Solana-confirmed traders from the Fomo.family leaderboard — wallets, volume, PnL, socials, hold time, and top holdings. Tokens are issued by 5 Star. There is no signup and no public key.

Base URL: https://copyfomo.join5star.xyz. JSON over HTTPS. Every consumer route below requires Authorization: Bearer <token> except this documentation.

Request a named token at contact@join5star.xyz.

A valid token can call GET /health, GET /traders, GET /traders/:id, and GET /tokens/:mint, including total_volume, twitter, bio, win_rate, avg_hold_time_secs, total_pnl, following, and pnl_all. Volume and profile fields refresh on the scheduled Fomo sync. twitter and win_rate are stored when Fomo sends them — Fomo currently leaves most Twitter fields empty and does not send a win-rate field.

Authentication

Send the token 5 Star issued you as a Bearer token. No other header is required. A missing, malformed, or unknown token returns 401 with {"error":"unauthorized"}.

Authorization: Bearer $COPYFOMO_TOKEN

Write and session routes use a separate operator secret. A consumer token always receives 401 there — that is correct, not a misconfiguration.

Rate limits

30 requests per 60 seconds per issued token. Going over returns 429 with {"error":"rate limited"}. Each consumer has its own bucket; two bots with two tokens do not share quota.

The snapshot is refreshed on a scheduled sync. Use last_synced_at on a trader, or lastSync on /health, rather than polling faster than you need.

Endpoints

Only traders with confirmed Solana holdings appear in list and lookup responses. A Fomo profile that has a Solana address but no nonzero Solana position is omitted (and a direct lookup returns 404) so you never follow a wallet that cannot fire on Solana.

Sync freshness and trader count. Does not return the Fomo login, cookies, or JWT value.

curl -sS https://copyfomo.join5star.xyz/health \
  -H "Authorization: Bearer $COPYFOMO_TOKEN"

{
  "host": "cloudflare-worker",
  "ok": true,
  "traders": 188,
  "jwtExpiresAt": "2026-09-17T12:04:00.000Z",
  "hasBrowserSession": true,
  "lastSync": "2026-09-17T00:12:04.000Z"
}

Paginated leaderboard of Solana-confirmed traders, sorted by a PnL window.

curl -sS "https://copyfomo.join5star.xyz/traders?limit=50&window=24h" \
  -H "Authorization: Bearer $COPYFOMO_TOKEN"

{
  "traders": [
    {
      "id": "fomo-uuid",
      "solana_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "evm_address": "0xabc…",
      "handle": "somehandle",
      "display_name": "Some Handle",
      "avatar_url": "https://…",
      "followers": 1204,
      "num_trades": 318,
      "total_volume": 184220.5,
      "clan_name": null,
      "pnl_24h": 4120.11,
      "pnl_7d": 18840.02,
      "pnl_30d": 55210.4,
      "last_synced_at": "2026-09-17 00:12:04",
      "twitter": "somehandle",
      "bio": "…",
      "win_rate": 0.61,
      "avg_hold_time_secs": 5400,
      "total_pnl": 128440.0
    }
  ],
  "limit": 50,
  "offset": 0,
  "window": "24h",
  "total": 188
}

total is the Solana-confirmed population, not the page size. Newer profile fields (twitter, bio, win_rate, avg_hold_time_secs, total_pnl) are nullable until a sync has filled them.

One trader plus their top holdings. :id may be the Fomo id, the handle (with or without a leading @, case-insensitive), or the Solana address (exact, base58).

curl -sS https://copyfomo.join5star.xyz/traders/somehandle \
  -H "Authorization: Bearer $COPYFOMO_TOKEN"

{
  "trader": { "id": "fomo-uuid", "handle": "somehandle", "following": 80, "pnl_all": 128440.0 },
  "holdings": [
    {
      "id": 12,
      "trader_id": "fomo-uuid",
      "token_address": "So11111111111111111111111111111111111111112",
      "network_id": 1399811149,
      "human_amount": 12.4,
      "price": 148.2,
      "value": 1837.68,
      "pnl": 220.5,
      "image_url": "https://…"
    }
  ]
}

Unknown, non-Solana-confirmed, or unmatched lookups return 404 {"error":"not found"}. The trader object is the full row, including following, pnl_all, and internal change-detection hashes (trader_hash, holdings_hash) which you can ignore.

Which tracked traders currently hold this Solana mint, ranked by position value. Capped at 20. network_id is always Solana (1399811149). Holder rows include the same Fomo profile fields as the leaderboard (twitter, bio, win_rate, avg_hold_time_secs, total_pnl).

curl -sS https://copyfomo.join5star.xyz/tokens/So11111111111111111111111111111111111111112 \
  -H "Authorization: Bearer $COPYFOMO_TOKEN"

{
  "mint": "So11111111111111111111111111111111111111112",
  "count": 2,
  "holders": [
    {
      "id": "fomo-uuid",
      "handle": "somehandle",
      "display_name": "Some Handle",
      "avatar_url": "https://…",
      "followers": 1204,
      "pnl_24h": 4120.11,
      "pnl_7d": 18840.02,
      "pnl_30d": 55210.4,
      "pnl_all": 128440.0,
      "twitter": "somehandle",
      "bio": "…",
      "win_rate": 0.61,
      "avg_hold_time_secs": 5400,
      "total_pnl": 128440.0,
      "human_amount": 12.4,
      "price": 148.2,
      "value": 1837.68,
      "position_pnl": 220.5,
      "network_id": 1399811149
    }
  ]
}

Errors

Every error body is JSON with an error string. There is no envelope wrapper on success.

Responses set Content-Type: application/json; charset=utf-8 and Cache-Control: no-store.

Field reference

Trader

Holding

What a read token can see

Request a token

Send a short note to contact@join5star.xyz with your project, the endpoints you need, and expected volume. We issue read tokens individually. This page is the full consumer contract.

Request API access