{"openapi":"3.1.0","info":{"title":"FOMO Data API","version":"1.0.0","description":"Social trading data from FOMO (fomo.family): token market panel and stats, top holders with handles and P&L, posted theses, trade activity and trader profiles. Every /v1 route costs one x402 micropayment.","x-guidance":"All routes are GET and cost 0.001 USDC per call via x402 on eip155:8453; an unpaid request returns 402 with payment requirements. Identify a token by chain slug (solana, base, ethereum, bsc, monad) or numeric network id plus its mint/contract address. Start with GET /v1/token/{chain}/{address} for price, market cap, volume, buy/sell stats and safety warnings. Use /holders for the top FOMO traders holding the token (handle, position, P&L, thesis), /theses for the reasoning traders posted, /activity for the live trade tape. Use GET /v1/profile/{handle} to evaluate a trader seen in holders or activity; include=trades,balances,rank adds their history. Responses are { data, meta }; meta.observedAt and meta.source tell how fresh the data is. Pass maxAge=<seconds> to require fresher data or stale=1 to accept any cached copy instantly.","contact":{"email":"contact@x4o2.com"}},"servers":[{"url":"https://fomo.x4o2.com"}],"paths":{"/v1/token/{chain}/{address}":{"get":{"operationId":"getToken","tags":["Tokens"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"summary":"Token overview from FOMO: price, market cap, volume, liquidity, buy/sell stats, warnings","description":"Current FOMO market panel for one token (price, market cap, 24h volume, liquidity, holder count), its trading statistics (buy/sell counts and volumes over 5m and 24h, unique buyers/sellers, top-10 holder share) and FOMO's safety warnings. Use for a quick quantitative read on a Solana or Base token.\n\nPaid: 0.001 USDC per call via x402 (eip155:8453). Unpaid requests receive 402 with payment requirements.","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string"},"description":"solana, base, ethereum, bsc, monad or a numeric network id","example":"solana"},{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token mint (Solana) or contract address (EVM)","example":"So11111111111111111111111111111111111111112"},{"name":"maxAge","in":"query","required":false,"schema":{"type":"string"},"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed","example":"5"},{"name":"stale","in":"query","required":false,"schema":{"type":"string"},"description":"1 returns any cached copy immediately and refreshes in the background","example":"0"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}}},"example":{"data":{"market":{"isHiddenFromDiscovery":false,"basePair":{"address":"So11111111111111111111111111111111111111112","symbol":"SOL","logo":"https://metadata.mobula.io/assets/logos/solana_solana_So11111111111111111111111111111111111111112.webp"},"buyCount1":null,"buyCount4":null,"buyCount12":null,"buyCount24":null,"change5m":"0.0028684025554119776","change1":"-0.011060791441624645","change4":"-0.013502958846225054","change12":"-0.06045670263182625","change24":"-0.10497589657172489","createdAt":1785083564,"exchanges":[{"name":"PumpSwap"}],"holders":141279,"top10HoldersPercent":null,"liquidity":"1469326.7610704848","marketCap":"55941312.2596957","pair":{"protocol":"PumpAmm"},"priceUSD":"0.05802145477279522","sellCount1":null,"sellCount4":null,"sellCount12":null,"sellCount24":null,"token":{"address":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","decimals":6,"networkId":1399811149,"createdAt":1785083564,"name":"Cate","symbol":"CATE","freezable":null,"mintable":null,"isScam":null,"i18n":null,"info":{"address":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","circulatingSupply":"964148735.64882","cmcId":null,"description":null,"id":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump:1399811149","imageBannerUrl":null,"imageLargeUrl":"https://metadata.mobula.io/assets/logos/solana_solana_Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump.webp","imageSmallUrl":"https://metadata.mobula.io/assets/logos/solana_solana_Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump.webp","imageThumbUrl":"https://metadata.mobula.io/assets/logos/solana_solana_Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump.webp","name":"Cate","networkId":1399811149,"symbol":"CATE","totalSupply":"964148735.64882"},"socialLinks":{"discord":null,"telegram":"https://t.me/catecoin_telegram","twitter":"https://x.com/i/communities/2004330768022004131","website":"https://cate.meme/","others":{"dexscreenerMetadataFields":["logo","dexscreenerHeader"]}},"launchpad":{"launchpadName":"Pump.fun","launchpadIconUrl":"https://crypto-exchange-logos-production.s3.us-west-2.amazonaws.com/6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P.webp","graduationPercent":100,"migrated":true}},"txnCount1":596,"txnCount4":2132,"txnCount12":9244,"txnCount24":28362,"uniqueBuys1":null,"uniqueBuys4":null,"uniqueBuys12":null,"uniqueBuys24":null,"uniqueSells1":null,"uniqueSells4":null,"uniqueSells12":null,"uniqueSells24":null,"volume1":"40617.479186542114","volume5m":"10932.619521454537","volume4":"200978.7984210127","volume12":"766949.3845114824","volume24":"2477269.5831413968"},"statistics":{"buyCount5m":38,"buyCount1":183,"buyCount4":423,"buyCount24":5506,"buyVolume5m":"1889","buyVolume1":"9701","buyVolume4":"72208","buyVolume24":"892382","sellCount5m":8,"sellCount1":67,"sellCount4":337,"sellCount24":4637,"sellVolume5m":"6925","sellVolume1":"22888","sellVolume4":"83804","sellVolume24":"905928","uniqueBuys5m":20,"uniqueBuys1":60,"uniqueBuys4":155,"uniqueBuys24":1812,"uniqueSells5m":5,"uniqueSells1":53,"uniqueSells4":164,"uniqueSells24":1885,"holders":140358,"top10HoldersPercent":13.319739578244832,"isLowFees":false},"warnings":{"disableBuying":false,"disableSelling":false,"warnings":[]}},"meta":{"observedAt":1792064874995,"ageMs":3162773,"source":"fresh","parts":{"market":{"observedAt":1792068037125,"source":"fresh"},"statistics":{"observedAt":1792068037125,"source":"fresh"},"warnings":{"observedAt":1792064874995,"source":"cache"}}}}}}},"400":{"description":"Invalid chain, address, handle or query"},"402":{"description":"Payment Required"},"503":{"description":"Temporarily busy or unavailable; honour Retry-After or pass stale=1"}}}},"/v1/token/{chain}/{address}/holders":{"get":{"operationId":"getTokenHolders","tags":["Tokens"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"summary":"Top FOMO holders of a token with handle, position, P&L and thesis","description":"The FOMO users holding the most of a token: each holder's FOMO handle and id, token amount, position value, cost basis, realized and unrealized P&L, hold time, developer flag and their posted thesis. Covers holders who trade on FOMO, not every on-chain wallet. Use for social and holder analysis of a token.\n\nPaid: 0.001 USDC per call via x402 (eip155:8453). Unpaid requests receive 402 with payment requirements.","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string"},"description":"solana, base, ethereum, bsc, monad or a numeric network id","example":"solana"},{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token mint (Solana) or contract address (EVM)","example":"So11111111111111111111111111111111111111112"},{"name":"maxAge","in":"query","required":false,"schema":{"type":"string"},"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed","example":"5"},{"name":"stale","in":"query","required":false,"schema":{"type":"string"},"description":"1 returns any cached copy immediately and refreshes in the background","example":"0"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}}},"example":{"data":{"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"topHolders":[{"user":{"id":"df983a8b-5e5b-5e91-802f-1472e96f04c3","address":"HXCYBexdXRrNTa3NHHJiKh5wsjb6zfW79MxQYGsszouu","evmAddress":"0xee368a44d334ab499b25efabbc879548d7be4143","createdAt":"2025-11-11T13:50:41.428Z","displayName":"PoorGoat💛🐈","userHandle":"PoorGoat_","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/f5eff84fd61177cfe9371f56d15dcf71_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"Road to 8 Figs 💛🐈\nFind me on X @poorgoat_\nI WILL NEVER ENDORSE A POORGOAT COIN\nNever blindly follow anyone’s trades...","following":46,"followers":591200,"activated":false,"verified":false,"isReferred":false,"isRestricted":false,"swapCount":1812,"numTrades":4377,"totalVolume":1563642.269831,"private":false,"thumbhash":"JVoODwLolqZ4d4h/l2iId5h3ifYHZ30A","coverPhotoLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/61edf29f1d74e084a99d189230d2028d.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","coverPhotoThumbhash":"zSgKGoSLiYe/l8h5e7+998o=","twitter":null,"clan":null,"badge":{"type":"top_100_badge","title":"Top 100","text":"Awarded to traders who have reached all-time top 100 on the leaderboard","image":null,"metadata":{"rank":6,"totalPnL":1875306.009245778}}},"tradeId":"1074837b-640e-44b2-aa27-cb0fe6f68ef9","sumSwapOpen":33222827.14,"sumTransferIn":69323.47,"isExternallyReceived":false,"humanAmount":27535448.12,"price":0.0577557043633,"value":1590329.2,"pnl":1542283.96,"unrealizedPnl":1474460.73,"realizedPnl":67823.23,"costBasis":140092.53,"averageEntryPrice":0.00420797,"comment":{"id":"t2-67b6d6f20eba5d9abd6afa1348f695746117025459b809765160569fce3f5152-1a614da1","userId":"df983a8b-5e5b-5e91-802f-1472e96f04c3","tradeId":"1074837b-640e-44b2-aa27-cb0fe6f68ef9","comment":"Study CATE’s relative strength while the rest of the market bleeds.\n\nThe coin of the cycle is showing its hand.\n\nCATE...","priceUsdAtCreation":0.0636401655202,"marketCapAtCreation":61373079.583845794,"fdvAtCreation":61373079.583845794,"createdAt":"2026-10-14T18:09:40.869Z","parentId":null,"numLikes":421,"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"reactions":{"counts":{"likeCount":421},"reactions":{"like":false}},"olderThesis":1723,"newerThesis":0,"shortCommentSegments":[{"text":"Study CATE’s relative strength while the rest of the market bleeds.\n\nThe coin of the cycle is showing its hand.\n\nCATE...","link":null,"provider":null}]},"numReplies":0,"showComment":true,"averageHoldTimeSeconds":322188,"isDev":false},{"user":{"id":"c3eac5cf-e699-5d5b-8593-a767ea739932","address":"2r8Z99rdDQNuiGHBoK1bbfVvifiYUwofc8e7wUz7S7Qm","evmAddress":"0x8f634d1a20c2f866954e4f6f24ba12d252f4f0df","createdAt":"2026-08-23T21:43:04.648Z","displayName":"bluntz","userHandle":"bluntz_capital","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/b382da4fde3a39853ed741e6b5b7bead_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"","following":30,"followers":81800,"activated":false,"verified":false,"isReferred":true,"isRestricted":false,"swapCount":1478,"numTrades":1721,"totalVolume":20393772.817418,"private":false,"thumbhash":"0xkOLwIZN3d4h3hwh3uHOLh4d5QIN3oA","coverPhotoLink":null,"coverPhotoThumbhash":null,"twitter":null,"clan":null},"tradeId":"8bd1803c-6bd3-444e-9204-38ea9441ebfb","sumSwapOpen":27701668.11,"sumTransferIn":205.945,"isExternallyReceived":false,"humanAmount":27395096.91,"price":0.0577557043633,"value":1582223.12,"pnl":30445.82,"unrealizedPnl":20330.11,"realizedPnl":10115.7,"costBasis":1579383.47,"averageEntryPrice":0.0570136,"comment":{"id":"t2-b5a96822428950caadf6159bc5f23e25630a6378ee67fdfda3d714df2237e56c-fb3f414d","userId":"c3eac5cf-e699-5d5b-8593-a767ea739932","tradeId":"8bd1803c-6bd3-444e-9204-38ea9441ebfb","comment":"in a sea of red, $cate up 17% and the top performer of the day.\n\nnice rounded bottom forming here, i think its safe t...","priceUsdAtCreation":0.0641751297517,"marketCapAtCreation":61888986.51284237,"fdvAtCreation":61888986.51284237,"createdAt":"2026-10-14T20:53:37.341Z","parentId":null,"numLikes":278,"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"reactions":{"counts":{"likeCount":278},"reactions":{"like":false}},"olderThesis":41,"newerThesis":0,"shortCommentSegments":[{"text":"in a sea of red, $cate up 17% and the top performer of the day.\n\nnice rounded bottom forming here, i think its safe t...","link":null,"provider":null}]},"numReplies":0,"showComment":true,"averageHoldTimeSeconds":249237,"isDev":false}],"totalHolders":92716},"meta":{"observedAt":1792068037773,"ageMs":614,"source":"fresh","parts":{"holders":{"observedAt":1792068037773,"source":"fresh"}}}}}}},"400":{"description":"Invalid chain, address, handle or query"},"402":{"description":"Payment Required"},"503":{"description":"Temporarily busy or unavailable; honour Retry-After or pass stale=1"}}}},"/v1/token/{chain}/{address}/theses":{"get":{"operationId":"getTokenTheses","tags":["Tokens"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"summary":"Theses FOMO traders posted on a token, with likes, replies and the poster's position","description":"The thesis feed for one token: the text each FOMO trader attached to their trade, who posted it, like and reply counts, when it was posted and the trade it belongs to. Pass thread=<tradeId> to also return the reply thread under one thesis. Use to read trader sentiment and reasoning on a token.\n\nPaid: 0.001 USDC per call via x402 (eip155:8453). Unpaid requests receive 402 with payment requirements.","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string"},"description":"solana, base, ethereum, bsc, monad or a numeric network id","example":"solana"},{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token mint (Solana) or contract address (EVM)","example":"So11111111111111111111111111111111111111112"},{"name":"maxAge","in":"query","required":false,"schema":{"type":"string"},"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed","example":"5"},{"name":"stale","in":"query","required":false,"schema":{"type":"string"},"description":"1 returns any cached copy immediately and refreshes in the background","example":"0"},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Number of theses, 1-100","example":"50"},{"name":"thread","in":"query","required":false,"schema":{"type":"string"},"description":"Trade id (uuid) whose reply thread to include"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}}},"example":{"data":{"theses":{"items":[{"type":"thesis","id":"t2-5f662457b1121b7081e45de28283d0dd443bfff585281bbce66579492fb79e2e-758d7d32","tradeId":"4aef8943-8eb3-4b99-90bf-36949c654afe","createdAt":"2026-10-15T12:37:42.646Z","userId":"be021325-e3d2-5dae-8208-a04ad5bd1067","displayName":"wessam","userHandle":"wessam","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/874fc4fab2258aeecf79a11c169b2192_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","verified":false,"twitter":null,"comment":{"id":"t2-5f662457b1121b7081e45de28283d0dd443bfff585281bbce66579492fb79e2e-758d7d32","userId":"be021325-e3d2-5dae-8208-a04ad5bd1067","tradeId":"4aef8943-8eb3-4b99-90bf-36949c654afe","comment":"Catellionere soon 👀🚀🚀🚀","priceUsdAtCreation":0.0584033052793,"marketCapAtCreation":56322774.67487729,"fdvAtCreation":56322774.67487729,"createdAt":"2026-10-15T12:37:42.646Z","parentId":null,"numLikes":0,"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"shortCommentSegments":[{"text":"Catellionere soon 👀🚀🚀🚀","link":null,"provider":null}],"reactions":{"counts":{"likeCount":0},"reactions":{"like":false}},"olderThesis":153,"newerThesis":0},"numReplies":0,"authorTrade":{"humanTokenAmount":24858.71,"usdValue":1435.73,"unrealizedPnlUsd":-101.282,"realizedPnlUsd":0,"percentageUnrealizedPnl":-6.5895,"percentageRealizedPnl":0,"closedAt":null},"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"ticker":"CATE","tokenImageUrl":"https://token-media.defined.fi/1399811149_Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump_small_ca0d4b10f481.png","equity":0,"threshold":1435.73,"isDev":false},{"type":"thesis","id":"t2-cb6c71bfb6bb5dab30cc544810579a7bc2f3c1d55f5dae3d9101e14d034491ee-467812a9","tradeId":"54b7ec7a-d7de-44c2-83db-99963f78051b","createdAt":"2026-10-15T12:37:16.578Z","userId":"0883a565-25cd-5346-b735-73aeff9d320c","displayName":"1217ad","userHandle":"1217ad","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/5e2204effdf87e34f9ae13dd36544102_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","verified":false,"twitter":null,"comment":{"id":"t2-cb6c71bfb6bb5dab30cc544810579a7bc2f3c1d55f5dae3d9101e14d034491ee-467812a9","userId":"0883a565-25cd-5346-b735-73aeff9d320c","tradeId":"54b7ec7a-d7de-44c2-83db-99963f78051b","comment":"We’ve literally been stuck in 50s for like a month","priceUsdAtCreation":0.0584033052793,"marketCapAtCreation":56322774.67487729,"fdvAtCreation":56322774.67487729,"createdAt":"2026-10-15T12:37:16.578Z","parentId":null,"numLikes":0,"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"shortCommentSegments":[{"text":"We’ve literally been stuck in 50s for like a month","link":null,"provider":null}],"reactions":{"counts":{"likeCount":0},"reactions":{"like":false}},"olderThesis":7,"newerThesis":0},"numReplies":0,"authorTrade":{"humanTokenAmount":5807.38,"usdValue":335.409,"unrealizedPnlUsd":28.4932,"realizedPnlUsd":0,"percentageUnrealizedPnl":9.28372,"percentageRealizedPnl":0,"closedAt":null},"tokenAddress":"Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","networkId":1399811149,"ticker":"CATE","tokenImageUrl":"https://token-media.defined.fi/1399811149_Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump_small_ca0d4b10f481.png","equity":0,"threshold":335.409,"isDev":false}],"hasNextPage":true,"count":1088715},"thread":null},"meta":{"observedAt":1792068038393,"ageMs":647,"source":"fresh","parts":{"theses":{"observedAt":1792068038393,"source":"fresh"}}}}}}},"400":{"description":"Invalid chain, address, handle or query"},"402":{"description":"Payment Required"},"503":{"description":"Temporarily busy or unavailable; honour Retry-After or pass stale=1"}}}},"/v1/token/{chain}/{address}/activity":{"get":{"operationId":"getTokenActivity","tags":["Tokens"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"summary":"Recent FOMO trading activity on a token: who bought or sold, how much, at what price","description":"The token's trade tape as FOMO shows it: recent buys, sells and transfers by FOMO users with handle, USD amount, price and market cap at the time. Use to see which traders are active in a token right now.\n\nPaid: 0.001 USDC per call via x402 (eip155:8453). Unpaid requests receive 402 with payment requirements.","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string"},"description":"solana, base, ethereum, bsc, monad or a numeric network id","example":"solana"},{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token mint (Solana) or contract address (EVM)","example":"So11111111111111111111111111111111111111112"},{"name":"maxAge","in":"query","required":false,"schema":{"type":"string"},"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed","example":"5"},{"name":"stale","in":"query","required":false,"schema":{"type":"string"},"description":"1 returns any cached copy immediately and refreshes in the background","example":"0"},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Number of events, 1-100","example":"50"},{"name":"threshold","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum USD size of events to include","example":"0"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}}},"example":{"data":{"items":[{"type":"swap_buy","id":"6a2d6cf7-b927-4353-805d-fcfd1daf9717","tradeId":"2176c010-ae72-4d71-83d3-550de9443833","createdAt":"2026-10-15T12:40:20.000Z","userId":"ee7fd5e2-4b17-56b2-b3c5-7914f1333db4","displayName":"often","userHandle":"often","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/32653d35c8a55a0ad3520ac8f5a2fbec_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","verified":false,"twitter":null,"usdAmount":250,"marketCap":56063300,"fdv":56063300,"price":0.0581342,"displayPriceUsd":0.0581342,"isDev":false},{"type":"swap_sell","id":"4ad5e374-579c-415b-b22c-decbaa5bc3da","tradeId":"77d56706-7d8e-4a7a-9c1c-48de6373a90a","createdAt":"2026-10-15T12:40:15.000Z","userId":"343aab04-3afb-5c7e-85fc-7e1ecabe3512","displayName":"learner_go","userHandle":"learner_go","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/24e98c76750b5f074cd9d8b7c4223036_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","verified":false,"twitter":null,"usdAmount":45.07,"marketCap":55697200,"fdv":55697200,"price":0.0577546,"displayPriceUsd":0.0577546,"isDev":false}],"hasNextPage":true},"meta":{"observedAt":1792068039042,"ageMs":218,"source":"fresh","parts":{"tokenActivity":{"observedAt":1792068039042,"source":"fresh"}}}}}}},"400":{"description":"Invalid chain, address, handle or query"},"402":{"description":"Payment Required"},"503":{"description":"Temporarily busy or unavailable; honour Retry-After or pass stale=1"}}}},"/v1/profile/{handle}":{"get":{"operationId":"getProfile","tags":["Profiles"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"summary":"A FOMO trader's profile: followers, trade counts, volume, P&L, hold time; optionally trades, balances, rank","description":"The public profile of one FOMO user by handle: id, follower and following counts, swap and trade counts, total volume, average hold time and recent P&L. Add include=trades,balances,rank to also return their trade history, current token balances and leaderboard rank. Use to evaluate a trader seen in holder or activity data.\n\nPaid: 0.001 USDC per call via x402 (eip155:8453). Unpaid requests receive 402 with payment requirements.","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"},"description":"FOMO user handle","example":"fomo"},{"name":"maxAge","in":"query","required":false,"schema":{"type":"string"},"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed","example":"5"},{"name":"stale","in":"query","required":false,"schema":{"type":"string"},"description":"1 returns any cached copy immediately and refreshes in the background","example":"0"},{"name":"include","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated extras: trades, balances, rank, spotlight","example":"trades,balances"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}}},"example":{"data":{"profile":{"id":"df983a8b-5e5b-5e91-802f-1472e96f04c3","address":"HXCYBexdXRrNTa3NHHJiKh5wsjb6zfW79MxQYGsszouu","evmAddress":"0xee368a44d334ab499b25efabbc879548d7be4143","createdAt":"2025-11-11T13:50:41.428Z","displayName":"PoorGoat💛🐈","userHandle":"PoorGoat_","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/f5eff84fd61177cfe9371f56d15dcf71.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"Road to 8 Figs 💛🐈\nFind me on X @poorgoat_\nI WILL NEVER ENDORSE A POORGOAT COIN\nNever blindly follow anyone’s trades...","following":46,"followers":591200,"activated":false,"verified":false,"isReferred":false,"isRestricted":false,"swapCount":1812,"numTrades":540,"totalVolume":1563642.269831,"private":false,"thumbhash":"JVoODwLolqZ4d4h/l2iId5h3ifYHZ30A","coverPhotoLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/61edf29f1d74e084a99d189230d2028d.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","coverPhotoThumbhash":"zSgKGoSLiYe/l8h5e7+998o=","twitter":null,"clan":null,"followsCurrentUser":false,"numFriendsFollowing":19,"friendsFollowing":[{"id":"dfb1811d-8f69-5f2c-b7d3-5aa08349c61c","address":"J881rS6fQrUFPq9UgR6p2vPDp7HbttnSYbdWgbT4YDnc","evmAddress":"0xb97ebc10f2ca8ad7f5bbfbb44df96d4680b45f34","createdAt":"2025-10-25T17:36:09.505Z","displayName":"Evanss6","userHandle":"Evan_ss6","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/5d0eea9e871e309857c903cc76862ed3_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"Hedgooor, there is no need to be upset\nPositions here are not investment/trading advice.","following":189,"followers":4238,"activated":true,"verified":false,"isReferred":true,"isRestricted":false,"swapCount":37,"numTrades":16,"totalVolume":10747.857487,"private":false,"thumbhash":"LigKDwa2x7iji2iFe2p4iFmJ/1tkr0YI","coverPhotoLink":null,"coverPhotoThumbhash":null,"twitter":null,"clanBadge":{"type":"clan","title":"Hedgooor","text":"Awarded for being in a clan","image":"https://prod-fomo-profile-pics.s3.amazonaws.com/dd72c26a2e74902f9f803ba8468ac9a0.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","metadata":{"clanId":"80159dbe-a27d-49f3-8a16-322d054ddb7f","memberType":"founder"}}},{"id":"546f4d95-2c4d-5203-8cbd-d38a7b5e23e5","address":"6Zz935v5HLmoTDgqvp94iVxzaAUg18tcqnAZZBDRsF2s","evmAddress":"0x41a8757a31d4a52f8facffdcc1576430090cd48b","createdAt":"2026-02-01T18:23:22.287Z","displayName":"Kyle Willson","userHandle":"KyleWillson","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/bc1d3c722dd961c352841c314995754d_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"degen dad -\n$1k to $1m challenge","following":70,"followers":182,"activated":false,"verified":false,"isReferred":false,"isRestricted":false,"swapCount":58,"numTrades":28,"totalVolume":1838.413679,"private":false,"thumbhash":"H2oOJwT1aHiaioZ1d5iIl3h4ab9Y95oE","coverPhotoLink":null,"coverPhotoThumbhash":null,"twitter":null,"clanBadge":{"type":"clan","title":"Degen Dads","text":"Awarded for being in a clan","image":"https://prod-fomo-profile-pics.s3.amazonaws.com/f0417065c333d7e90e1790aacbee6622.png?k=288ODoc5KpQ0vhzAW8b8BrsXg","metadata":{"clanId":"1cb8805d-04f7-49af-b84a-3ee278e68787","memberType":"member"}}}],"averageHoldTimeSeconds":322188,"badge":{"type":"top_100_badge","title":"Top 100","text":"Awarded to traders who have reached all-time top 100 on the leaderboard","image":null,"metadata":{"rank":6,"totalPnL":1875306.009245778}}},"trades":null,"balances":null,"rank":{"id":"df983a8b-5e5b-5e91-802f-1472e96f04c3","address":"HXCYBexdXRrNTa3NHHJiKh5wsjb6zfW79MxQYGsszouu","evmAddress":"0xee368a44d334ab499b25efabbc879548d7be4143","createdAt":"2025-11-11T13:50:41.428Z","displayName":"PoorGoat💛🐈","userHandle":"PoorGoat_","profilePictureLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/f5eff84fd61177cfe9371f56d15dcf71_small.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","description":"Road to 8 Figs 💛🐈\nFind me on X @poorgoat_\nI WILL NEVER ENDORSE A POORGOAT COIN\nNever blindly follow anyone’s trades...","following":46,"followers":591200,"activated":false,"verified":false,"isReferred":false,"isRestricted":false,"swapCount":1812,"numTrades":4377,"totalVolume":1563642.269831,"private":false,"thumbhash":"JVoODwLolqZ4d4h/l2iId5h3ifYHZ30A","coverPhotoLink":"https://prod-fomo-profile-pics.s3.amazonaws.com/61edf29f1d74e084a99d189230d2028d.jpg?k=288ODoc5KpQ0vhzAW8b8BrsXg","coverPhotoThumbhash":"zSgKGoSLiYe/l8h5e7+998o=","twitter":null,"rank":{"rank":6,"pnl":1875306.009245778},"rank24h":{"rank":688042,"pnl":-315589.6684668097},"rank7d":{"rank":779504,"pnl":-47129.880263763014},"rank30d":{"rank":858452,"pnl":-649128.6002947097},"rankCampaigns":{},"badge":{"type":"top_100_badge","title":"Top 100","text":"Awarded to traders who have reached all-time top 100 on the leaderboard","image":null,"metadata":{"rank":6,"totalPnL":1875306.009245778}}},"spotlight":null},"meta":{"observedAt":1792068039262,"ageMs":1031,"source":"fresh","parts":{"profile":{"observedAt":1792068039262,"source":"fresh"},"rank":{"observedAt":1792068039791,"source":"fresh"}}}}}}},"400":{"description":"Invalid chain, address, handle or query"},"402":{"description":"Payment Required"},"503":{"description":"Temporarily busy or unavailable; honour Retry-After or pass stale=1"}}}}},"components":{"schemas":{"Meta":{"type":"object","description":"Freshness of the response","properties":{"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed"},"ageMs":{"type":"integer"},"source":{"type":"string","enum":["cache","fresh","stale"]},"parts":{"type":"object"}}}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Free API key from https://x4o2.com/keys (email login). Served while the service has spare capacity, else 429 with Retry-After; paid x402 requests always go through."}}}}