FomoScan

Endpoints (21 live)

• GET /v2/user/id/aefe2ddd-c580-5245-a2f5-e4ed62f7ef10 — Resolve a FOMO trader by stable user id (User.id or thesis authorId from a prior call). Prefer this once you have stored an id — cheaper and stable vs handle. Returns the current profile including wallets. Do not pass a handle or wallet. (0.1 USDC on Solana)
• GET /v2/user/handle/frankdegods — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/thesis/user/aefe2ddd-c580-5245-a2f5-e4ed62f7ef10 — Theses written by one FOMO trader, newest first. {id} is the stable user id (User.id / authorId), not a handle — resolve handle→id first if needed. Page with ?before= from nextBefore. Use the /token/{tokenAddress} sibling when you also know the token. (0.01 USDC on Solana)
• GET /v2/user/wallet/498g1rVnFcnjBjpfw1xyqA1WvgQXUU8RWuELjxkjAayQ — Resolve a FOMO trader by verified Solana or 0x-prefixed EVM wallet. Use only when you have an on-chain address and neither handle nor user id — $2.00 vs $0.10 for those. Same User profile. EVM addresses must include 0x. (0.2 USDC on Solana)
• GET /v2/thesis/token/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump — Theses about one token (mint or 0x contract), newest first — what traders are saying plus their PnL/holdings on that token. Use when you have a token address. Page with ?before= from nextBefore. Do not pass a user id or handle as tokenAddress. (0.01 USDC on Solana)
• GET /v2/thesis/user/aefe2ddd-c580-5245-a2f5-e4ed62f7ef10/token/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump — Theses by one trader about one token. Use when you have both a stable user id and a token address — more targeted than listing all of a user's theses. {id} is user id, not handle. Page with ?before= from nextBefore. (0.01 USDC on Solana)
• GET /v2/user/handle/0xOuroboros — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/user/handle/OfficeWorker — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/user/handle/NachoTrades — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/user/handle/dingalingts — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/user/wallet/0xD5938dc56E24350cA762557F0b6253f1B2d2f8cb — Resolve a FOMO trader by verified Solana or 0x-prefixed EVM wallet. Use only when you have an on-chain address and neither handle nor user id — $2.00 vs $0.10 for those. Same User profile. EVM addresses must include 0x. (0.2 USDC on Solana)
• GET /v2/user/handle/overdose_ai — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)
• GET /v2/user/wallet/7tCETmedwBk4zFjmq7xcDo1vCMDTFNfDkobXyNj2grR3 — Resolve a FOMO trader by verified Solana or 0x-prefixed EVM wallet. Use only when you have an on-chain address and neither handle nor user id — $2.00 vs $0.10 for those. Same User profile. EVM addresses must include 0x. (0.2 USDC on Solana)
• GET /v2/thesis/token/0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120 — Theses about one token (mint or 0x contract), newest first — what traders are saying plus their PnL/holdings on that token. Use when you have a token address. Page with ?before= from nextBefore. Do not pass a user id or handle as tokenAddress. (0.01 USDC on Solana)
• GET /v2/thesis — Newest-first global feed of FOMO theses (short trade write-ups: token, author, PnL, holdings). Use only when you have no token or author filter. Page with ?before= from nextBefore; stop when hasMore is false. Dedupe items on id. Prefer the token/user-scoped routes when you know those. (0.01 USDC on Solana)
• GET /v2/thesis/user/1 — Theses written by one FOMO trader, newest first. {id} is the stable user id (User.id / authorId), not a handle — resolve handle→id first if needed. Page with ?before= from nextBefore. Use the /token/{tokenAddress} sibling when you also know the token. (0.01 USDC on Solana)
• GET /v2/user/id/1 — Resolve a FOMO trader by stable user id (User.id or thesis authorId from a prior call). Prefer this once you have stored an id — cheaper and stable vs handle. Returns the current profile including wallets. Do not pass a handle or wallet. (0.1 USDC on Solana)
• GET /v2/thesis/token/1 — Theses about one token (mint or 0x contract), newest first — what traders are saying plus their PnL/holdings on that token. Use when you have a token address. Page with ?before= from nextBefore. Do not pass a user id or handle as tokenAddress. (0.01 USDC on Solana)
• GET /v2/user/wallet/1 — Resolve a FOMO trader by verified Solana or 0x-prefixed EVM wallet. Use only when you have an on-chain address and neither handle nor user id — $2.00 vs $0.10 for those. Same User profile. EVM addresses must include 0x. (0.2 USDC on Solana)
• GET /v2/user/handle/1 — Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id. (0.1 USDC on Solana)

+1 more endpoint.