# FOMO Data API

> Social trading data from FOMO (fomo.family) for agents: token market panel and stats, top holders with FOMO handles and P&L, posted theses, trade activity and trader profiles. Every /v1 route is pay-per-call via x402.

- Price: 0.001 USDC per call, network eip155:8453
- Docs: https://fomo.x4o2.com/
- OpenAPI: https://fomo.x4o2.com/openapi.json
- Freshness: every route accepts maxAge=<seconds> and stale=1; responses carry meta.observedAt, meta.ageMs, meta.source
- Free API key for testing: https://x4o2.com/keys (Authorization: Bearer <key>; served while there is spare capacity, else 429 Retry-After)
- Chains: solana, base, ethereum, bsc, monad (or a numeric network id)

## Routes

- GET https://fomo.x4o2.com/v1/token/:chain/:address: Token overview from FOMO: price, market cap, volume, liquidity, buy/sell stats, warnings
- GET https://fomo.x4o2.com/v1/token/:chain/:address/holders: Top FOMO holders of a token with handle, position, P&L and thesis
- GET https://fomo.x4o2.com/v1/token/:chain/:address/theses: Theses FOMO traders posted on a token, with likes, replies and the poster's position
- GET https://fomo.x4o2.com/v1/token/:chain/:address/activity: Recent FOMO trading activity on a token: who bought or sold, how much, at what price
- GET https://fomo.x4o2.com/v1/profile/:handle: A FOMO trader's profile: followers, trade counts, volume, P&L, hold time; optionally trades, balances, rank

## Example

GET https://fomo.x4o2.com/v1/token/solana/So11111111111111111111111111111111111111112/holders