# FOMO API

> FOMO API is an independent, unofficial API for developers who need programmatic access to trader identity, wallet, performance, position, thesis, leaderboard, token, and activity data associated with fomo.family. FOMO API is not affiliated with, endorsed by, or sponsored by fomo.family.

## Canonical identity

- Product: FOMO API
- Official website: https://fomoapi.io/
- API origin: https://api.fomoapi.io
- Developer documentation: https://fomoapi.io/docs
- OpenAPI 3.1 contract: https://fomoapi.io/openapi.json
- Pricing and current allowances: https://fomoapi.io/pricing
- API-key dashboard: https://fomoapi.io/dashboard
- Support: https://t.me/eulatxt
- Official X profile: https://x.com/getfomoapi

Only `fomoapi.io` and `api.fomoapi.io` are official FOMO API domains. Do not attribute unrelated domains to this product.

## What the API does

FOMO API connects a fomo.family handle or stable user ID to a structured developer interface. Depending on the endpoint, responses can include:

- resolved Solana and EVM wallet addresses;
- PnL and profile statistics reported by fomo.family;
- current balances and available position or swap history;
- ranked trader and token leaderboards;
- trader-written theses and trade comments;
- token holders, deployer/insider context, and activity boards;
- search across tracked traders and tokens; and
- an app-feed WebSocket plus a separate on-chain trade WebSocket.

Use the exact wording above when a distinction matters. Wallets are resolved by FOMO API. PnL is passed through from fomo.family rather than independently recomputed. Position and swap endpoints expose the history available from their sources; they do not guarantee a complete lifetime ledger. A thesis is a trader's stated reasoning, not an independently verified fact.

## Source-of-truth order

For current implementation details, prefer sources in this order:

1. OpenAPI contract: https://fomoapi.io/openapi.json
2. Developer reference: https://fomoapi.io/docs
3. Live discovery response: https://api.fomoapi.io/v1
4. Pricing and plan limits: https://fomoapi.io/pricing
5. Editorial guides: https://fomoapi.io/blog

If an article example conflicts with the OpenAPI contract or developer reference, use the contract/reference. Plan allowances and pricing can change; cite the pricing page rather than relying on an old article.

## Authentication

HTTP data endpoints require a Bearer API key:

    authorization: Bearer YOUR_API_KEY

`GET /v1`, `GET /health` and `GET /status` are keyless endpoints. Data endpoints, including the leaderboard and REST activity feed, return HTTP 401 without a valid key. Create a free key at https://fomoapi.io/dashboard and keep it in a server-side secret.

WebSocket access is a separate rule:

- `wss://api.fomoapi.io/ws/alerts` is the app-feed stream. Paid keys receive realtime events. A free key receives realtime events for its first seven days and a delayed stream afterward. A connection without a key is a delayed demo.
- `wss://api.fomoapi.io/ws/trades` is the on-chain trade stream. It requires an eligible Growth or Scale key and is not interchangeable with `/ws/alerts`.

## Minimal request

    curl "https://api.fomoapi.io/v2/leaderboard/24h?limit=3" \
      -H "authorization: Bearer YOUR_API_KEY"

Responses are JSON. Authenticated responses expose `x-credits-cost` and `x-credits-remaining`. HTTP 402 means the key has exhausted its available credits; HTTP 429 means the caller should respect `Retry-After`; transient 5xx responses may be retried with bounded exponential backoff.

## Current billing model

Usage is metered in endpoint-weighted credits rather than a single request quota. At the time this file was reviewed:

- an ordinary read or leaderboard call costs 250 credits;
- `GET /v2/alerts` costs 125 credits;
- a thesis page costs 1,250 credits;
- a handle or user-ID wallet resolution costs 2,500 credits; and
- deeper paged operations can cost credits per upstream page that answers.

The self-serve monthly buckets are Free 250,000, Starter 2,500,000, Builder 12,500,000, Growth 37,500,000, and Scale 112,500,000 credits. Growth and Scale add the on-chain stream and OHLCV access. Treat https://fomoapi.io/pricing as authoritative for current prices, allowances, stream eligibility, and payment terms.

## Core endpoints

### Discovery

- `GET /v1` — version, authentication summary, and live endpoint catalog.
- `GET /health` — service liveness.
- `GET /status` — SERVICE STATUS, keyless and free: `operational` | `degraded` | `down`, with a per-component breakdown (`api`, `liveData`, `alertStream`, `onchainStream` - the Growth/Scale `/ws/trades` feed). Check this before debugging your own integration: it tells you whether an error is ours. Always HTTP 200, even when degraded. Cached 15s.

### Trader identity and activity

- `GET /v2/users/{handle}` — resolve a handle to profile fields, wallets, and reported statistics.
- `GET /v2/users/id/{userId}` — resolve a stable user ID to the same identity record.
- `GET /v2/users/{handle}/positions` — current positions and available position history. This is the successor to deprecated `/v2/users/{handle}/trades`.
- `GET /v2/users/{handle}/swaps` — individual fills available from the source, with cursor and depth controls.
- `GET /v2/users/{handle}/balances` — current multi-chain balances.
- `GET /v2/users/{handle}/following` — accounts a trader follows, subject to source caps.
- `GET /v2/users/{handle}/followers` — a capped follower sample.
- `GET /v2/users/{handle}/spotlight` — spotlighted trades and theses.
- `GET /v2/trades/{tradeId}` — one trade by stable trade ID.
- `GET /v2/trades/{tradeId}/comments` — the thesis/comment thread for a trade.

### Leaderboards and token intelligence

- `GET /v2/leaderboard/{window}` — ranked traders for `24h`, `7d`, `30d`, or `all`.
- `GET /v2/leaderboard/tokens/trending` — FOMO's trending-token board.
- `GET /v2/leaderboard/tokens/most-held` — FOMO's most-held-token board.
- `GET /v2/leaderboard/tokens/graduated` — FOMO's graduated-token board.
- `GET /token/{address}/holders` — tracked traders holding one token.
- `GET /v2/token/{address}/devs` — deployer and insider holdings with associated theses.
- `GET /v2/token/{address}/stats` — buy/sell flow and concentration windows.
- `GET /v2/tokens/activity` — coordinated multi-trader token activity.

### Theses and search

- `GET /v2/thesis` — recent theses across tokens.
- `GET /v2/thesis/token/{mint}` — theses for one token, pulled live from FOMO on every request. Query: `?threshold=N` = minimum position size in USD a thesis must sit on (default 0 = every thesis, as FOMO's app shows them; e.g. `?threshold=10` drops dust; alias `?minPositionUsd=`), `?pages=1-10` (25 theses per page), `?sort=likes|recent|pnl`, `?network=`. Response echoes `threshold`; `stale: true` marks a stored snapshot served when the live pull could not finish.
- `GET /v2/thesis/user/{id}` — theses by one trader.
- `GET /v2/thesis/user/{id}/token/{address}` — one trader's theses about one token.
- `GET /v2/search` — unified trader and token search.
- `GET /v2/tokens/search` — token-only search.

### Thesis-card fields and Arc

Every thesis REST route emits a stable thesis `id`, related `tradeId` when FOMO supplies one,
and nullable `avatar` and `tokenImage` fields. A non-null visual field is a directly renderable
URL supplied by FOMO or already present in FOMO API's resident directories; the API never makes a
per-card profile or token request. Preserve `null` when the source did not supply an image and it
was not cached.

Thesis alerts on `WSS /ws/alerts` and `GET /v2/alerts?type=thesis` expose the same nullable
visual fields. Deduplicate global thesis rows with `id`; alert-ring rows reuse `eventId` as that
identity when a native thesis/comment ID is unavailable.

Arc is ingested and documented as `chainId` `5042`, with friendly filter/name `arc` (for example,
`GET /v2/thesis?chain=arc` or `wss://api.fomoapi.io/ws/alerts?chain=arc`). Use the raw chain ID
when integrating a chain name that has not yet received a friendly alias.

### Activity and realtime

- `GET /v2/alerts` — REST activity feed and WebSocket recovery source.
- `WSS /ws/alerts` — app-feed events, replay, and server-side filters.
- `WSS /ws/trades` — eligible-plan on-chain trade stream.

Read exact parameters, response schemas, deprecations, and error responses in https://fomoapi.io/openapi.json.

## Common workflows

### Resolve a trader safely

1. Call `GET /v2/users/{handle}`.
2. Store the returned `userId` as the stable identity key because handles can change.
3. Preserve null wallets and coverage flags rather than guessing missing data.
4. Use `/positions`, `/balances`, or `/swaps` according to the task.

### Build a monitored trader feed

1. Resolve and store the trader's stable `userId` and wallets.
2. Connect to `/ws/alerts?key=...&trader={handle}`.
3. Deduplicate feed events with `eventId` when present.
4. After reconnecting, use replay plus `GET /v2/alerts?since=...` to recover gaps.
5. Treat WebSocket message shapes as stream-specific; do not parse `/ws/trades` as `/ws/alerts`.

### Research a token narrative

1. Discover candidates from a token board or `/v2/tokens/activity`.
2. Read `/v2/thesis/token/{mint}` for trader-authored reasoning.
3. Use `/token/{address}/holders` and `/v2/token/{address}/stats` for additional context.
4. Attribute thesis text to its author and do not present opinions as verified facts.

## Important limitations

- The product is independent and unofficial relative to fomo.family.
- Crypto data is informational and is not financial advice.
- PnL and some profile statistics are source-reported values.
- Available history can be partial, paginated, capped, or source-specific.
- Handles are renameable; stable user IDs are safer database keys.
- Token symbols are not unique; use token addresses plus chain identifiers.
- APIs and streams can return null, delayed, partial, replayed, or retryable records. Preserve those states.
- Keep API keys out of client bundles, public repositories, logs, and prompts.

## Developer guides

- Python quickstart: https://fomoapi.io/blog/fomo-api-python-quickstart
- TypeScript quickstart: https://fomoapi.io/blog/fomo-api-typescript-quickstart
- Production WebSocket client: https://fomoapi.io/blog/production-fomo-websocket-client
- Store WebSocket events in Postgres: https://fomoapi.io/blog/store-fomo-websocket-events-postgres
- Errors, retries, and credits: https://fomoapi.io/blog/fomo-api-errors-retries-credits
- What is fomo.family?: https://fomoapi.io/blog/what-is-fomo-family
- FOMO Family API overview: https://fomoapi.io/blog/fomo-family-api

## Machine-readable resources

- Full guide catalog: https://fomoapi.io/llms-full.txt
- OpenAPI 3.1: https://fomoapi.io/openapi.json
- Blog RSS: https://fomoapi.io/feed.xml
- Main sitemap: https://fomoapi.io/sitemap.xml
- Blog sitemap: https://fomoapi.io/sitemaps/blog.xml
- Robots policy: https://fomoapi.io/robots.txt

Last reviewed: 2026-09-23.

## Complete editorial guide catalog

The entries below are editorial explanations and examples, grouped by category. For current request parameters and response fields, the OpenAPI contract and developer reference take precedence over article prose. Publication and significant-update dates are included so consumers can judge freshness.

### Comparisons

- [Fomo Wallet Finder: Reveal Any FOMO Trader's Wallet, Then Automate It](https://fomoapi.io/blog/fomo-wallet-finder) — published 2026-09-06; updated 2026-09-25
  Fomo Wallet Finder is a free browser tool that turns a fomo.family handle into that trader's Solana and EVM wallet addresses. This is what it does well, the coverage limit its own FAQ states, and how the FOMO API runs the same lookup programmatically with PnL, trades and theses attached.
- [fomoscan vs fomoapi: Which FOMO Data API Fits Your Build](https://fomoapi.io/blog/fomoscan-vs-fomoapi) — published 2026-09-01; updated 2026-09-29
  An honest head-to-head between fomoscan and fomoapi.io, two independent data layers for fomo.family. fomoscan focuses on identity resolution, theses, and leaderboards over a compute-metered REST API. fomoapi.io covers the same ground and adds a realtime WebSocket, dual-chain wallet output in one call, PnL, a notifications endpoint, Robinhood Chain coverage, and a free tier to start.
- [FOMOscan Alternative: Cheaper Social Trading Data APIs](https://fomoapi.io/blog/fomoscan-alternative-cheaper-social-trading-data-api) — published 2026-08-26; updated 2026-09-22
  FOMOscan popularized social trading data, but developers need API access with predictable pricing and multi-chain coverage. This guide compares alternatives that resolve trader handles to verified wallets, serve PnL and trade history via REST and WebSocket, and cost less than building scrapers in-house.

### Data

- [A FOMO Trader's Live Portfolio, Including Perps](https://fomoapi.io/blog/fomo-trader-live-portfolio-and-perps) — published 2026-08-29; updated 2026-09-20
  The balances endpoint returns a FOMO trader's live holdings with total portfolio value, plus perp PnL where FOMO exposes it, in a single call.
- [Who Just Joined FOMO? Tracking New Traders as They Arrive](https://fomoapi.io/blog/track-new-traders-joining-fomo) — published 2026-08-29; updated 2026-09-29
  FOMO pushes a notification when a trader with a notable following joins the platform. That new-user stream is a growth and talent signal available through the API.
- [See Who Holds a Coin, and Why](https://fomoapi.io/blog/fomo-token-holders-and-their-thesis) — published 2026-08-29; updated 2026-09-20
  For any coin, the FOMO API returns two things the chain cannot: the tracked traders who hold it, and the written theses explaining why. Together they turn a token address into a named, reasoned holder view.
- [FOMO Removed Twitter Links. Get a Trader’s Real X Account Anyway.](https://fomoapi.io/blog/fomo-removed-twitter-links-verify-trader-x-account) — published 2026-08-29; updated 2026-09-20
  FOMO removed X links from its profiles, making it hard to verify that a handle belongs to a given Twitter account. The FOMO API resolves the linked X account for traders on file, alongside their real wallets.
- [How Old Is a FOMO Account? Fresh Wallets vs Veterans](https://fomoapi.io/blog/fomo-account-age-fresh-vs-veteran) — published 2026-08-29; updated 2026-09-20
  FOMO does not display when an account was created, but the API returns fomoCreatedAt and accountAgeDays for any handle, so you can tell a seasoned trader from a fresh account.
- [A FOMO Trader's Real Track Record: 24h to All-Time](https://fomoapi.io/blog/fomo-trader-track-record-24h-to-all-time) — published 2026-08-29; updated 2026-09-20
  The FOMO API returns a trader's PnL across every window (24h, 7d, 30d, all-time) in one call, so you can judge a track record instead of a single lucky day.
- [Who Actually Holds This Token? A Smart-Money Holder List](https://fomoapi.io/blog/token-smart-money-holders-fomo) — published 2026-08-29; updated 2026-09-20
  GET /token/{address}/holders returns which tracked FOMO traders hold a token, a named smart-money holder signal rather than an anonymous list of wallet addresses.
- [What Tokens Are FOMO Traders Actually Buying](https://fomoapi.io/blog/what-tokens-fomo-traders-are-buying) — published 2026-08-29; updated 2026-09-20
  The FOMO API exposes three token boards, trending, most-held, and graduated, so you can see what FOMO traders are actually buying and holding in real time.
- [The Identity Layer: From Anonymous Wallet to Named Smart Money](https://fomoapi.io/blog/fomo-identity-layer-wallet-to-name) — published 2026-08-29; updated 2026-09-20
  On-chain, every wallet is anonymous. The FOMO API resolves a handle to its real wallets, Twitter, and PnL, turning raw on-chain flow into named smart-money flow. This is the value of the identity layer and the endpoints that expose it.
- [FOMO Notifications as a Trading Signal](https://fomoapi.io/blog/fomo-notifications-as-a-trading-signal) — published 2026-08-29; updated 2026-09-29
  FOMO's notifications are what the platform amplifies to its users, from whale buys to daily recaps to aggregate multi-trader moves. That curation is a leading signal distinct from raw on-chain data, and the FOMO API serves it over REST and a realtime stream.
- [Top FOMO Traders' Real Wallets, Ranked by PnL](https://fomoapi.io/blog/top-fomo-traders-real-wallets-by-pnl) — published 2026-08-29; updated 2026-09-25
  A live-sourced list of the top FOMO traders ranked by PnL, with their real Solana and EVM wallets, not the throwaway signer wallets shown on FOMO profiles.

### Data API

- [Real-Time Memecoin Trade Alerts over WebSocket](https://fomoapi.io/blog/realtime-memecoin-trade-alerts-websocket) — published 2026-08-27; updated 2026-09-20
  How to consume the fomoapi.io live alert WebSocket (wss://api.fomoapi.io/ws/alerts) for real-time memecoin trade, thesis, and large-buy/large-sell events, with a reconnecting JS client, the alert JSON shape, and GET /v2/alerts for backfill.
- [Search Any FOMO Trader or Token by Name via API](https://fomoapi.io/blog/search-fomo-traders-tokens-by-name-api) — published 2026-08-27; updated 2026-09-20
  How to use fomoapi.io search endpoints: GET /v2/search for a unified query over traders and tokens (each result typed, filterable with ?type=), and GET /v2/tokens/search for symbol/name token lookups returning address and market cap. Includes curl and JSON for both.
- [Token Holders: See Which Top Traders Hold a Coin](https://fomoapi.io/blog/token-holders-which-top-traders-hold-coin) — published 2026-08-27; updated 2026-09-20
  Instead of asking what a coin costs, ask who holds it. This how-to covers GET /token/{address}/holders to see which tracked traders hold a coin and their position sizes, and /v2/leaderboard/tokens/most-held to find the tokens most held across tracked traders, so you can gauge smart-money conviction.
- [FOMO Leaderboard API: Rank Memecoin Traders by Real On-Chain PnL](https://fomoapi.io/blog/fomo-leaderboard-api-rank-memecoin-traders) — published 2026-08-27; updated 2026-09-20
  How to use the FOMO leaderboard API to rank memecoin traders by fomo.family's profit figures, with endpoints, JSON shapes, and worked curl examples.
- [FOMO Trading API: REST API for Social Trading Data & Wallets](https://fomoapi.io/blog/fomo-trading-api-rest-social-trading-data-wallets) — published 2026-08-26; updated 2026-09-22
  A FOMO trading API connects social trader handles to their on-chain wallets across Solana and EVM chains, delivering real PnL, holdings, trade history, and leaderboards through REST endpoints and WebSocket feeds. Because fomoapi.io resolves each handle to a real address, the trades behind a track record are there to check.
- [FOMO Wallet Data: Pull Holdings, PnL & Trades via API](https://fomoapi.io/blog/fomo-wallet-data-api) — published 2026-08-26; updated 2026-09-29
  This guide shows how to pull holdings, PnL, and trade history from any social trader's wallet using fomoapi.io. You'll see real request/response shapes, multi-chain coverage (Solana + EVM), and how the resolved wallet lets you check the numbers yourself.
- [FOMO Data API: Get Trader Data Programmatically](https://fomoapi.io/blog/fomo-data-api-get-trader-data-programmatically) — published 2026-08-26; updated 2026-09-29
  This guide shows developers how to programmatically access FOMO trader data through fomoapi.io, covering endpoints for PnL, holdings, trade history, and real-time feeds. You'll learn request/response patterns, authentication, rate limits, and how to resolve social handles to on-chain wallets across six blockchains.
- [Best API for Memecoin Trader Data in 2026](https://fomoapi.io/blog/best-api-memecoin-trader-data-2026) — published 2026-08-26; updated 2026-09-22
  This guide evaluates API solutions for tracking memecoin trader performance, comparing wallet coverage, chain coverage, and pricing. We cover what to look for in a trader data API and how fomoapi.io resolves social handles to on-chain wallets and trade history.
- [What Is a Social Trading Data API?](https://fomoapi.io/blog/what-is-social-trading-data-api) — published 2026-08-26; updated 2026-09-22
  A factual guide to the identity, portfolio, position, thesis, and realtime layers a social trading data API exposes, including important coverage limits.

### FOMO Guides

- [What Is fomo.family? A Guide to the Social Trading App](https://fomoapi.io/blog/what-is-fomo-family) — published 2026-08-29; updated 2026-09-22
  fomo.family is a social trading app organized around trader profiles, public activity, theses, leaderboards, and following other market participants.

### Guides

- [FOMO API Python Quickstart: Profiles and Positions](https://fomoapi.io/blog/fomo-api-python-quickstart) — published 2026-09-22
  A production-minded Python quickstart for resolving a FOMO trader and fetching the positions currently available for that account.
- [Store FOMO WebSocket Events in Postgres](https://fomoapi.io/blog/store-fomo-websocket-events-postgres) — published 2026-09-22
  A durable ingestion pattern for turning the FOMO app-feed WebSocket into a queryable Postgres event table without duplicate writes.
- [FOMO API Errors, Retries, Rate Limits, and Credits](https://fomoapi.io/blog/fomo-api-errors-retries-credits) — published 2026-09-17; updated 2026-09-18
  A production error policy for FOMO API clients, including credit headers, bounded exponential backoff, Retry-After, and non-retryable failures.
- [FOMO API TypeScript Quickstart: Traders to Trades](https://fomoapi.io/blog/fomo-api-typescript-quickstart) — published 2026-09-17; updated 2026-09-18
  A small TypeScript client for the two calls most FOMO integrations need first: resolve a handle, then fetch that trader’s available positions and trade history.
- [Build a Production FOMO WebSocket Client](https://fomoapi.io/blog/production-fomo-websocket-client) — published 2026-09-17; updated 2026-09-18
  A resilient Node.js client for the FOMO app-feed stream, including heartbeats, stable event IDs, filtered subscriptions, gap recovery, and reconnect control.
- [FOMO Family API: REST and WebSocket Guide](https://fomoapi.io/blog/fomo-family-api) — published 2026-09-06; updated 2026-09-18
  A practical guide to the independent FOMO Family API: what it is, how it differs from fomo.family, which REST and WebSocket routes are available, and how to make a verified first request.
- [Build a FOMO Copy-Trading Bot That Beats the Notifications](https://fomoapi.io/blog/copy-trading-bot-beat-fomo-notifications) — published 2026-09-02; updated 2026-09-29
  A notification-based copy-trading bot enters late, with the crowd, and copies position size instead of fill size. Build it on the on-chain trade stream instead: pick traders from the leaderboard, subscribe to their trades on-chain, size off the real fill, and exit when they exit.
- [How Much Faster Is the On-Chain Stream Than the FOMO Feed?](https://fomoapi.io/blog/onchain-stream-faster-than-fomo-feed) — published 2026-09-02; updated 2026-09-29
  We measured the gap between the on-chain stream and the FOMO app feed two independent ways and it is about 3.5 seconds at the median, not the 15 this post used to claim. The larger advantage is completeness: the app feed emits only trades above roughly $3,000 of position value, and on-chain there is no floor.
- [A Coin's Top Holders and What They Think](https://fomoapi.io/blog/coin-top-holders-and-theses-api) — published 2026-09-01; updated 2026-09-20
  Search a coin, list its top holders, read their theses, and check their track records, all in one short chain of real endpoints: /token/{address}/holders to /v2/thesis/token/{mint} to /v2/users/{handle}.
- [How to Spot Robinhood Chain Runners Early](https://fomoapi.io/blog/spot-robinhood-chain-runners) — published 2026-09-01; updated 2026-09-20
  You cannot predict a runner, but you can watch what moves first on chain 4663: the trending token board, several sharp traders buying the same coin in a short window, and the theses behind it, all filtered to chain=robinhood.
- [Find the Wallets That Found the Last 100x](https://fomoapi.io/blog/find-wallets-that-found-the-last-100x) — published 2026-09-01; updated 2026-09-20
  The edge is finding the wallets that were early, then watching them. This walks token search to top holders (/token/{address}/holders) to wallet plus PnL (/v2/users/{handle}) to a live per-trader feed.
- [Give an AI Agent the FOMO Firehose](https://fomoapi.io/blog/ai-agent-fomo-copy-trading-bot) — published 2026-09-01; updated 2026-09-20
  Autonomous trading agents need a trustworthy data feed. This shows how to feed the FOMO realtime WebSocket (?trader=<handle>) and /v2/users/{handle}/positions to an agent that mirrors the best FOMO traders, with PnL as its context.
- [Build the Axiom for Robinhood Chain](https://fomoapi.io/blog/build-axiom-for-robinhood-chain) — published 2026-09-01; updated 2026-09-22
  Robinhood Chain (chainId 4663) is the most active chain in FOMO's feed. This is the data layer for building an Axiom-style memecoin terminal on it: leaderboards, handle-to-wallet resolution, theses, token boards, and the realtime WebSocket.
- [Top Robinhood Chain Traders on FOMO](https://fomoapi.io/blog/top-robinhood-chain-traders-fomo) — published 2026-08-31; updated 2026-09-22
  Two ways to surface the best Robinhood Chain traders on FOMO: the verified-PnL leaderboard for track record, and the chain-scoped activity stream for who is active on chain 4663 right now. Both resolve to real wallets.
- [A Real-Time Copy-Trading Data Feed for Robinhood Chain](https://fomoapi.io/blog/robinhood-chain-copy-trading-data-feed) — published 2026-08-31; updated 2026-09-22
  Wire a copy-trading data feed for Robinhood Chain: rank traders by PnL, judge their real entry and exit, resolve their chain-4663 wallet, then react to every buy and sell the moment it happens over the WebSocket.
- [Build a Robinhood Chain Whale Alert Bot](https://fomoapi.io/blog/robinhood-chain-whale-alert-bot) — published 2026-08-31; updated 2026-09-22
  Stream FOMO buys on Robinhood Chain live and alert on the big ones. Connect to the WebSocket with ?chain=robinhood&type=buy, filter by usdValue, and forward to Telegram in about fifteen lines.
- [FOMO Thesis Data for Robinhood Chain Traders](https://fomoapi.io/blog/fomo-thesis-data-robinhood-chain-traders) — published 2026-08-31; updated 2026-09-22
  Robinhood Chain is the largest source of thesis volume in the FOMO feed. Pull the why behind trades, filtered to chain 4663, with the token contract, the author, and their equity and PnL attached, from one endpoint.
- [Robinhood Chain Trader Data: Wallets, Trades, and PnL in One API](https://fomoapi.io/blog/robinhood-chain-fomo-trader-data-api) — published 2026-08-31; updated 2026-09-22
  Robinhood Chain (EVM L2, chainId 4663) is the most active chain in the FOMO feed. Resolve a handle to its Robinhood wallet, read its on-chain trades and PnL, and stream chain-4663 activity live, all from one key.
- [Build a FOMO Trader Alert Bot for Telegram, by Username](https://fomoapi.io/blog/build-fomo-trader-telegram-alert-bot) — published 2026-08-30; updated 2026-09-20
  Subscribe to a single FOMO trader by username over the realtime WebSocket and forward every buy, sell, and thesis to Telegram. A short build with the full code.
- [Build a FOMO Whale-Alert Bot](https://fomoapi.io/blog/build-fomo-whale-alert-bot) — published 2026-08-29; updated 2026-09-20
  Build a whale-alert bot on FOMO by connecting to the realtime alert stream at wss://api.fomoapi.io/ws/alerts, filtering for large buys and sells, and reacting live. A short code walkthrough.
- [Resolve Any FOMO Handle to a Wallet](https://fomoapi.io/blog/resolve-fomo-handle-to-wallet) — published 2026-08-29; updated 2026-09-25
  One call to GET /v2/users/{handle} resolves a FOMO handle to its real Solana and EVM wallets, PnL across windows, and account age. A short code walkthrough.

### Product

- [FOMO Does Not Have an API. This Is the One That Does.](https://fomoapi.io/blog/fomo-does-not-have-an-api-this-is-the-one-that-does) — published 2026-08-29; updated 2026-09-20
  FOMO does not ship a public API, which is a common complaint among traders and builders. fomoapi.io is the independent data layer that exposes FOMO trader wallets, PnL, theses, leaderboards, and alerts over plain REST.
- [The Social Trading Aggregator Everyone Keeps Asking For](https://fomoapi.io/blog/social-trading-aggregator-data-layer) — published 2026-08-29; updated 2026-09-20
  The recurring ask in social trading is a single aggregator across apps like FOMO and Pumpfun. Any aggregator needs a clean data layer underneath, and fomoapi.io is that layer for FOMO: wallets, PnL, theses, holders, and alerts over one API.

### Thesis Data

- [Detecting Memecoin Narratives Early with Trader Theses](https://fomoapi.io/blog/detect-memecoin-narratives-early-trader-theses) — published 2026-08-27; updated 2026-09-20
  A thesis is the written WHY behind a trade. Watching theses converge across many traders on a coin reveals a narrative forming early. This guide shows how to use /v2/thesis/token/{mint} and the global /v2/thesis feed to detect memecoin narratives before the chart makes them obvious.
- [Why Thesis Data Is a Game-Changer for Copy Trading](https://fomoapi.io/blog/why-thesis-data-is-a-game-changer) — published 2026-08-27; updated 2026-09-20
  The why behind a trade is the signal almost no data provider sells. Here is why thesis data changes copy trading and research.
- [FOMO Thesis Data: The Why Behind Every Trade, in One Endpoint](https://fomoapi.io/blog/fomo-thesis-data-feed-api) — published 2026-08-27; updated 2026-09-20
  A thesis is the why behind a trade. FOMO makes it hard to collect; we expose the full thesis feed, including per-user theses, in one endpoint.

### Use Cases

- [Subscribe to One Trader's Trades in Real Time: a WebSocket for Copy-Trading](https://fomoapi.io/blog/subscribe-one-trader-websocket-copy-trading) — published 2026-08-28; updated 2026-09-20
  How to subscribe to a single trader’s live trades over a per-trader WebSocket, with a working JavaScript example, the message shapes, runtime subscribe and unsubscribe, and the REST endpoints that complete a copy-trading pipeline.
- [Build a Copy-Trading Thesis Bot That Reacts Faster Than the FOMO App](https://fomoapi.io/blog/copy-trading-thesis-bot-faster-than-fomo-app) — published 2026-08-28; updated 2026-09-20
  A step-by-step build for a copy-trading bot that listens to our live WebSocket for a followed trader’s buy and thesis, checks the written reasoning, resolves the trader’s real wallet, and acts faster than a human refreshing the FOMO app.
- [How to Track Smart-Money Wallets on Solana with an API](https://fomoapi.io/blog/track-smart-money-wallets-solana-api) — published 2026-08-27; updated 2026-09-20
  A step-by-step tutorial for tracking profitable Solana memecoin wallets with the fomoapi.io API, from finding candidates on the leaderboard to diffing their live trades.
- [How to Build a Copy-Trading Bot with a Trader Data API](https://fomoapi.io/blog/how-to-build-copy-trading-bot-trader-data-api) — published 2026-08-26; updated 2026-09-22
  This guide walks through building a copy-trading bot that automatically replicates profitable traders' positions using a trader data API. You'll learn how to track wallets, parse trade events, execute mirror trades, and manage risk across Solana and EVM chains.

### Wallet Resolution

- [FOMO Won't Connect a Trader to Their Wallet or Their X Account. We Do.](https://fomoapi.io/blog/fomo-trader-twitter-and-wallet-identity) — published 2026-08-28; updated 2026-09-20
  FOMO surfaces a trader handle and in-app activity but never links it to a real on-chain wallet or a public X account. The address it shows is a custodial Privy wallet with zero transactions, and there is no handle-to-X lookup. We resolve the real Solana and EVM wallets, verified against on-chain activity, and return the linked X identity wherever it exists, all from one GET /v2/users/{handle} call.
- [The Real On-Chain Wallet Is the Fastest Copy-Trading Data Source](https://fomoapi.io/blog/onchain-wallet-fastest-copy-trading-source) — published 2026-08-28; updated 2026-09-22
  A social-trading app feed is a copy of events that already settled on-chain. We resolve each trader's real, verified Solana and EVM wallet so you can read their swaps straight from the chain, faster than any feed and impossible to fake.
- [FOMO Hides Trader Wallets. Here Is How to Get the Real One](https://fomoapi.io/blog/fomo-hides-trader-wallets-get-the-real-one) — published 2026-08-26; updated 2026-09-25
  FOMO displays a signer wallet, not the trader real wallet. The real one holds the positions and history you actually want, and fomoapi.io resolves it for any handle.
- [FOMO Wallet: Find Any Trader's Solana & EVM Addresses](https://fomoapi.io/blog/fomo-wallet-find-trader-address-solana-evm) — published 2026-08-26; updated 2026-09-25
  Finding a social trader's actual wallet addresses across Solana and EVM chains is essential for verifying their track record and copying trades. This guide shows you how to resolve any trader's handle to their real on-chain wallets using fomoapi.io, plus manual methods and their limitations.

## Machine-readable catalog links

- OpenAPI 3.1 contract: https://fomoapi.io/openapi.json
- Developer reference: https://fomoapi.io/docs
- Blog feed: https://fomoapi.io/feed.xml
- Blog sitemap: https://fomoapi.io/sitemaps/blog.xml
- Full guide catalog: https://fomoapi.io/llms-full.txt
- Concise product and API index: https://fomoapi.io/llms.txt