fomo MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on fomo: 54 typed functions through one MCP server. No fomo API key needed.
- Site
- fomo.family
- Functions
- 54
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for fomo alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/fomoOne MCP server for fomo and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
filterTokensThe full token screener, a POST taking the site's own filter object and returning matching tokens with their market numbers.Arguments
Name Type Required filtersFomoFilterTokensArgsYes // Its field names are NOT recovered: fomo.family builds the body from React state, so // no literal in its bundle names them, and this provider neither lists nor validates // any. Any JSON object is passed through unchanged and the API rejects a bad field. interface FomoFilterTokensArgs { [field: string]: unknown; }Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/filterTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.filterTokens({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.filterTokens({}))curl -X POST https://api.bowmark.ai/v1/sites/fomo/filterTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"filters":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.filterTokens({});getAlertPreferencesReturns which push alerts the signed-in trader receives.Arguments
None.
HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getAlertPreferencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getAlertPreferences();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getAlertPreferences())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getAlertPreferences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getAlertPreferences();getBalancesReturns what one trader actually holds.Arguments
Name Type Required userIdstringYes Returns
FomoBalance[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoBalance { token: FomoToken; amount: DecimalString; valueUsd: number | null; unrealizedPnlUsd: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getBalancesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getBalances("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getBalances("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getBalances \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getBalances("user123");getCandlesReturns OHLCV bars for one token.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes options{ resolution?: FomoCandleResolution; from?: number; to?: number }No type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad"; /** The bar sizes the site's own chart is observed to request, see getCandles. */ type FomoCandleResolution = "5" | "60" | "240" | "720" | "1D";Returns
FomoCandle[]/** UNIX SECONDS, matching the TradingView datafeed contract, not milliseconds. */ interface FomoCandle { time: number; open: number; high: number; low: number; close: number; volume: number; } /** One OHLCV bar. `time` is UNIX SECONDS, matching the TradingView datafeed contract. */ interface FomoCandle { time: number; open: number; high: number; low: number; close: number; volume: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getCandlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getCandles("So11111111111111111111111111111111111111112", "solana");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getCandles("So11111111111111111111111111111111111111112", "solana"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getCandles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"So11111111111111111111111111111111111111112","chain":"solana"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getCandles("So11111111111111111111111111111111111111112", "solana");getClanReturns one clan, fomo's team unit, with its name, description, member count, leaderboard rank and window stats.Arguments
Name Type Required clanIdstringYes windowFomoLeaderboardWindowNo type FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime";Returns
FomoClantype FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime"; interface FomoTraderStats { pnlUsd: number | null; pnlPercent: number | null; volumeUsd: number | null; tradeCount: number | null; winRate: number | null; window: FomoLeaderboardWindow; } interface FomoClan { id: string; name: string; imageUrl: string | null; description: string | null; memberCount: number | null; rank: number | null; stats: FomoTraderStats | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getClanCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getClan("clan123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getClan("clan123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getClan \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clanId":"clan123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getClan("clan123");getClanFeedPages a clan's own feed and the theses its members have written.Arguments
Name Type Required clanIdstringYes cursorstringNo limitnumberNo Returns
FomoPage<FomoFeedItem>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; } /** One post in the signed-in trader's feed. The feed is trade-centric: most * entries ARE a trade, with an optional written thesis attached. */ interface FomoFeedItem { id: string; kind: string; author: FomoUser; trade: FomoTrade | null; thesis: string | null; reactionCount: number | null; commentCount: number | null; /** Whether the CALLING user has reacted. */ reacted: boolean | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getClanFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getClanFeed("clan123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getClanFeed("clan123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getClanFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clanId":"clan123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getClanFeed("clan123");getClanHoldingsReturns what a clan collectively holds.Arguments
Name Type Required clanIdstringYes limitnumberNo Returns
FomoClanHolding[]interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoClanHolding { token: FomoToken; holderCount: number | null; valueUsd: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getClanHoldingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getClanHoldings("clan123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getClanHoldings("clan123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getClanHoldings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clanId":"clan123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getClanHoldings("clan123");getClanHoldingsBreakdownBreaks one clan's position in ONE token down to the members holding it.Arguments
Name Type Required clanIdstringYes addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
unknown[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getClanHoldingsBreakdownCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getClanHoldingsBreakdown("clan123", "0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getClanHoldingsBreakdown("clan123", "0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getClanHoldingsBreakdown \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clanId":"clan123","address":"0xdac17f958d2ee523a2206206994597c13d831ec7","chain":"ethereum"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getClanHoldingsBreakdown("clan123", "0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");getClanThesisThe written theses a clan's members have posted.Arguments
Name Type Required clanIdstringYes limitnumberNo Returns
unknown[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getClanThesisCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getClanThesis("clan123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getClanThesis("clan123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getClanThesis \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clanId":"clan123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getClanThesis("clan123");getCurrentUserReturns the signed-in trader's own profile.Arguments
None.
Returns
FomoUserinterface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getCurrentUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getCurrentUser();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getCurrentUser())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getCurrentUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getCurrentUser();getDevHoldersReturns whether the token's own deployer still holds it, and how much.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
unknown[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getDevHoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getDevHolders("So11111111111111111111111111111111111111112", "solana");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getDevHolders("So11111111111111111111111111111111111111112", "solana"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getDevHolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"So11111111111111111111111111111111111111112","chain":"solana"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getDevHolders("So11111111111111111111111111111111111111112", "solana");getFeedPages the signed-in trader's social feed.Arguments
Name Type Required cursorstringNo limitnumberNo Returns
FomoPage<FomoFeedItem>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; } /** One post in the signed-in trader's feed. The feed is trade-centric: most * entries ARE a trade, with an optional written thesis attached. */ interface FomoFeedItem { id: string; kind: string; author: FomoUser; trade: FomoTrade | null; thesis: string | null; reactionCount: number | null; commentCount: number | null; /** Whether the CALLING user has reacted. */ reacted: boolean | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFeed())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFeed();getFollowersPages the traders following one user, newest first, with full profiles.Arguments
Name Type Required userIdstringYes cursorstringNo Returns
FomoPage<FomoUser>interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFollowers("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFollowers("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFollowers("user123");getFollowingPages the traders one user follows, newest first, with full profiles.Arguments
Name Type Required userIdstringYes cursorstringNo Returns
FomoPage<FomoUser>interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFollowingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFollowing("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFollowing("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFollowing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFollowing("user123");getFollowingIdsReturns just the ids of everyone the signed-in trader follows, in one call with no paging.Arguments
None.
Returns
string[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFollowingIdsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFollowingIds();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFollowingIds())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFollowingIds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFollowingIds();getFollowingLeaderboardThe same ranking as getLeaderboard, restricted to traders the signed-in user follows.Arguments
None.
Returns
FomoLeaderboardEntry[]type FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime"; interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTraderStats { pnlUsd: number | null; pnlPercent: number | null; volumeUsd: number | null; tradeCount: number | null; winRate: number | null; window: FomoLeaderboardWindow; } interface FomoLeaderboardEntry { rank: number; user: FomoUser; stats: FomoTraderStats; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFollowingLeaderboardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFollowingLeaderboard();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFollowingLeaderboard())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFollowingLeaderboard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFollowingLeaderboard();getFriendHoldersReturns which of the signed-in trader's own follows hold a given token.Arguments
Name Type Required tokensArray<{ address: string; chain: FomoChainSlug | number }>Yes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
unknown[][]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getFriendHoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getFriendHolders([ { address: "So11111111111111111111111111111111111111112", chain: "solana" } ]);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getFriendHolders([ { "address": "So11111111111111111111111111111111111111112", "chain": "solana" } ]))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getFriendHolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tokens":[{"address":"So11111111111111111111111111111111111111112","chain":"solana"}]}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getFriendHolders([ { address: "So11111111111111111111111111111111111111112", chain: "solana" } ]);getGraduatedTokensReturns tokens that have just completed their bonding curve and moved to a full AMM pool. 'Graduation' is the moment a launchpad token stops being a…Arguments
None.
Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getGraduatedTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getGraduatedTokens();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getGraduatedTokens())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getGraduatedTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getGraduatedTokens();getLeaderboardReturns the ranked traders for one window.Arguments
Name Type Required args{ window?: FomoLeaderboardWindow }No type FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime";Returns
FomoLeaderboardEntry[]type FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime"; interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTraderStats { pnlUsd: number | null; pnlPercent: number | null; volumeUsd: number | null; tradeCount: number | null; winRate: number | null; window: FomoLeaderboardWindow; } interface FomoLeaderboardEntry { rank: number; user: FomoUser; stats: FomoTraderStats; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getLeaderboardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getLeaderboard({ window: "weekly" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getLeaderboard({"window": "weekly"}))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getLeaderboard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"window":"weekly"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getLeaderboard({ window: "weekly" });getMajorTokensReturns the large-cap majors.Arguments
None.
Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getMajorTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getMajorTokens();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getMajorTokens())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getMajorTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getMajorTokens();getMostHeldTokensReturns the tokens held by the most fomo traders.Arguments
None.
Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getMostHeldTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getMostHeldTokens();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getMostHeldTokens())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getMostHeldTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getMostHeldTokens();getMutualsPages the traders both the signed-in user and another user follow.Arguments
Name Type Required userIdstringYes cursorstringNo Returns
FomoPage<FomoUser>interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getMutualsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getMutuals("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getMutuals("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getMutuals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getMutuals("user123");getPortfolioHistoryReturns the time series behind a trader's portfolio-value chart.Arguments
Name Type Required userIdstringYes Returns
FomoPortfolioPoint[]interface FomoPortfolioPoint { /** UNIX seconds, matching FomoCandle.time. */ time: number; valueUsd: number; /** The id getPortfolioSnapshot takes to expand this point into the full * position list held at that moment. */ snapshotId: string | null; } /** UNIX SECONDS, matching the TradingView datafeed contract, not milliseconds. */ interface FomoCandle { time: number; open: number; high: number; low: number; close: number; volume: number; } /** One OHLCV bar. `time` is UNIX SECONDS, matching the TradingView datafeed contract. */ interface FomoCandle { time: number; open: number; high: number; low: number; close: number; volume: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getPortfolioHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getPortfolioHistory("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getPortfolioHistory("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getPortfolioHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getPortfolioHistory("user123");getPortfolioSnapshotReturns one point of that series in full.Arguments
Name Type Required userIdstringYes snapshotIdstringYes Returns
FomoBalance[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoBalance { token: FomoToken; amount: DecimalString; valueUsd: number | null; unrealizedPnlUsd: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getPortfolioSnapshotCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getPortfolioSnapshot("user123", "snap123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getPortfolioSnapshot("user123", "snap123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getPortfolioSnapshot \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123","snapshotId":"snap123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getPortfolioSnapshot("user123", "snap123");getRecommendedUsersReturns fomo's own suggestions of traders to follow for one user.Arguments
Name Type Required userIdstringYes Returns
FomoUser[]interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getRecommendedUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getRecommendedUsers("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getRecommendedUsers("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getRecommendedUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getRecommendedUsers("user123");getReferralsReturns who the signed-in trader referred and what they have earned from it, plus their own referrer's details.Arguments
Name Type Required userIdstringYes cursorstringNo HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getReferralsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getReferrals("<userId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getReferrals("<userId>"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getReferrals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"<userId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getReferrals("<userId>");getReferrerDetailsReturns who referred the signed-in trader, and the terms attached.Arguments
Name Type Required userIdstringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getReferrerDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getReferrerDetails("<userId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getReferrerDetails("<userId>"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getReferrerDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"<userId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getReferrerDetails("<userId>");getTokenReturns one token's full detail.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
FomoTokenRowtype DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getToken("So11111111111111111111111111111111111111112", "solana");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getToken("So11111111111111111111111111111111111111112", "solana"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getToken \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"So11111111111111111111111111111111111111112","chain":"solana"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getToken("So11111111111111111111111111111111111111112", "solana");getTokenAllowlistReturns the list of tokens fomo allows trading on.Arguments
None.
Returns
FomoTokenAllowlistEntry[]/** A token in the allowlist, just its identity (address + networkId pair). */ interface FomoTokenAllowlistEntry { /** Contract address, or a Solana mint. */ address: string; /** fomo's chain id, 1399811149 for Solana, 8453 Base, 56 BNB, 1 Ethereum, 143 Monad. */ networkId: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenAllowlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTokenAllowlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTokenAllowlist())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTokenAllowlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTokenAllowlist();getTokenAllowlistDetailedThe token allowlist with each entry's full record.Arguments
None.
Returns
FomoToken[]interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenAllowlistDetailedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTokenAllowlistDetailed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTokenAllowlistDetailed())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTokenAllowlistDetailed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTokenAllowlistDetailed();getTokenFeedPages all trades for one token.Arguments
Name Type Required addressstringYes chainstringYes cursorstringNo limitnumberNo Returns
FomoPage<FomoTrade>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTokenFeed("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTokenFeed("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTokenFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","chain":"ethereum"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTokenFeed("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");getTokenThesisReturns the written theses traders have posted about one token, ranked by the site's own sort.Arguments
Name Type Required addressstringYes chainstringYes Returns
unknown[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenThesisCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTokenThesis("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTokenThesis("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTokenThesis \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","chain":"ethereum"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTokenThesis("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");getTokenWarningsReturns fomo's risk flags for one token.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
FomoTokenWarning[]/** A risk flag the site raises on a token's page, honeypot, mint authority, unlocked * liquidity, concentration. The site's own `code` is kept verbatim rather than mapped * to a severity of our invention. */ interface FomoTokenWarning { code: string; label: string; severity: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTokenWarningsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTokenWarnings("So11111111111111111111111111111111111111112", "solana");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTokenWarnings("So11111111111111111111111111111111111111112", "solana"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTokenWarnings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"So11111111111111111111111111111111111111112","chain":"solana"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTokenWarnings("So11111111111111111111111111111111111111112", "solana");getTopHoldersReturns the largest holders of each requested token, one result array per token in the same order.Arguments
Name Type Required tokensArray<{ address: string; chain: FomoChainSlug | number }>Yes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
unknown[][]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTopHoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTopHolders([ { address: "So11111111111111111111111111111111111111112", chain: "solana" } ]);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTopHolders([ { "address": "So11111111111111111111111111111111111111112", "chain": "solana" } ]))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTopHolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tokens":[{"address":"So11111111111111111111111111111111111111112","chain":"solana"}]}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTopHolders([ { address: "So11111111111111111111111111111111111111112", chain: "solana" } ]);getTradeReturns one trade in full by id, with its author and token.Arguments
Name Type Required tradeIdstringYes Returns
FomoTradetype DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTradeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTrade("trade123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTrade("trade123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTrade \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tradeId":"trade123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTrade("trade123");getTradeCommentsReturns the comment thread under one trade, in the site's own order.Arguments
Name Type Required tradeIdstringYes Returns
FomoComment[]interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoComment { id: string; author: FomoUser; body: string; reactionCount: number | null; reacted: boolean | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTradeCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTradeComments("trade123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTradeComments("trade123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTradeComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tradeId":"trade123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTradeComments("trade123");getTradesPages trades across the platform, optionally filtered to one trader by userId.Arguments
Name Type Required userIdstringNo cursorstringNo limitnumberNo Returns
FomoPage<FomoTrade>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTradesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTrades();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTrades())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTrades \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTrades();getTradingActivityFeedPages raw trading activity rather than the composed social feed.Arguments
Name Type Required cursorstringNo limitnumberNo Returns
FomoPage<FomoTrade>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTradingActivityFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTradingActivityFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTradingActivityFeed())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTradingActivityFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTradingActivityFeed();getTrendingTokensReturns what is moving on fomo right now.Arguments
None.
Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getTrendingTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getTrendingTokens();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getTrendingTokens())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getTrendingTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getTrendingTokens();getUserReturns one trader's public profile by fomo user id.Arguments
Name Type Required userIdstringYes Returns
FomoUserinterface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUser("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUser("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUser("user123");getUserByHandleReturns one trader's profile from their @handle.Arguments
Name Type Required handlestringYes Returns
FomoUserinterface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserByHandleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserByHandle("somehandle");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserByHandle("somehandle"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserByHandle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"somehandle"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserByHandle("somehandle");getUserLeaderboardStandingReturns one trader's own rank and stats without walking the board.Arguments
Name Type Required userIdstringYes Returns
FomoLeaderboardEntrytype FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime"; interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTraderStats { pnlUsd: number | null; pnlPercent: number | null; volumeUsd: number | null; tradeCount: number | null; winRate: number | null; window: FomoLeaderboardWindow; } interface FomoLeaderboardEntry { rank: number; user: FomoUser; stats: FomoTraderStats; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserLeaderboardStandingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserLeaderboardStanding("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserLeaderboardStanding("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserLeaderboardStanding \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserLeaderboardStanding("user123");getUserSpotlightReturns the highlighted trades and stats fomo pins to the top of one trader's profile.Arguments
Name Type Required userIdstringYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserSpotlightCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserSpotlight("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserSpotlight("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserSpotlight \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserSpotlight("user123");getUserSwapsPages one trader's own executed swaps.Arguments
Name Type Required userIdstringYes cursorstringNo Returns
FomoPage<FomoTrade>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTrade { id: string; user: FomoUser; token: FomoToken; /** The site's own word, "buy" / "sell". */ side: string; amount: DecimalString; amountUsd: number | null; priceUsd: DecimalString | null; pnlUsd: number | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserSwapsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserSwaps("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserSwaps("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserSwaps \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserSwaps("user123");getUserTransfersPages one trader's token transfers in and out.Arguments
Name Type Required userIdstringYes cursorstringNo Returns
FomoPage<FomoTransfer>type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; } interface FomoTransfer { id: string; direction: string; token: FomoToken; amount: DecimalString; amountUsd: number | null; counterparty: FomoUser | null; txHash: string | null; createdAt: string; } /** No route on this API publishes a total. Page until `cursor` is null. */ interface FomoPage<T> { items: T[]; cursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserTransfersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserTransfers("user123");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserTransfers("user123"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserTransfers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserTransfers("user123");getUserWithdrawalsReturns one trader's withdrawals off the platform for a given chain.Arguments
Name Type Required userIdstringYes chainstring | numberYes Returns
FomoWithdrawal[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoWithdrawal { id: string; token: FomoToken; amount: DecimalString; amountUsd: number | null; destinationAddress: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose txHash: string | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getUserWithdrawalsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getUserWithdrawals("user123", "solana");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getUserWithdrawals("user123", "solana"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/getUserWithdrawals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"user123","chain":"solana"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getUserWithdrawals("user123", "solana");getVerifiedTokensReturns the tokens fomo has verified.Arguments
None.
Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getVerifiedTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getVerifiedTokens();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getVerifiedTokens())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getVerifiedTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getVerifiedTokens();getWatchlistReturns every token the signed-in trader is watching, newest first.Arguments
None.
Returns
FomoWatchlistEntry[]interface FomoWatchlistEntry { networkId: number; tokenAddress: string; createdAt: string | null; assetType?: string; assetId?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/getWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.getWatchlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.getWatchlist())curl -X POST https://api.bowmark.ai/v1/sites/fomo/getWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.getWatchlist();searchClansSearches clans by name.Arguments
Name Type Required searchTermstringYes Returns
FomoClanRef[]interface FomoClanRef { id: string; name: string; imageUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/searchClansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.searchClans("test");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.searchClans("test"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/searchClans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"searchTerm":"test"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.searchClans("test");searchTokensSearches tokens by name, symbol or contract address and returns matching rows with their market numbers.Arguments
Name Type Required searchTermstringYes Returns
FomoTokenRow[]type DecimalString = string; interface FomoToken { address: string; /** 1399811149 Solana · 8453 Base · 56 BNB · 1 Ethereum · 143 Monad. */ networkId: number; name: string | null; symbol: string | null; decimals: number | null; imageUrl: string | null; info: { description: string | null; websiteUrl: string | null; twitterUrl: string | null; telegramUrl: string | null; discordUrl: string | null } | null; } interface FomoTokenRow { token: FomoToken; priceUSD: DecimalString; /** A PERCENT, not a fraction. */ change24: number | null; volume24: number | null; marketCap: number | null; liquidity: number | null; holders: number | null; /** Bonding-curve progress; null once the token has graduated to an AMM pool. */ graduationPercent: number | null; createdAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/searchTokensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.searchTokens("sol");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.searchTokens("sol"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/searchTokens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"searchTerm":"sol"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.searchTokens("sol");searchUsersFuzzy-searches traders by handle or display name and returns matching profiles.Arguments
Name Type Required searchTermstringYes Returns
FomoUser[]interface FomoUser { id: string; userHandle: string; displayName: string | null; bio: string | null; avatarUrl: string | null; followerCount: number | null; followingCount: number | null; twitterHandle: string | null; clan: { id: string; name: string; imageUrl: string | null } | null; isFollowing: boolean | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/searchUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.searchUsers("test");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.searchUsers("test"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/searchUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"searchTerm":"test"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.searchUsers("test");
addToWatchlistAdds a token to the signed-in trader's watchlist.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
FomoWatchlistChangeinterface FomoWatchlistChange { watching: boolean; tokenAddress: string; networkId: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/addToWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.addToWatchlist("<address>", "<chain>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.addToWatchlist("<address>", "<chain>"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/addToWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"<address>","chain":"<chain>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.addToWatchlist("<address>", "<chain>");removeFromWatchlistRemoves a token from the signed-in trader's watchlist.Arguments
Name Type Required addressstringYes chainFomoChainSlug | numberYes type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";Returns
FomoWatchlistChangeinterface FomoWatchlistChange { watching: boolean; tokenAddress: string; networkId: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/removeFromWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.removeFromWatchlist("<address>", "<chain>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.removeFromWatchlist("<address>", "<chain>"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/removeFromWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"<address>","chain":"<chain>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.removeFromWatchlist("<address>", "<chain>");setAlertPreferencesWrites the signed-in trader's push-notification preferences.Arguments
Name Type Required preferencesunknownYes HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fomo/setAlertPreferencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fomo.setAlertPreferences("<preferences>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fomo.setAlertPreferences("<preferences>"))curl -X POST https://api.bowmark.ai/v1/sites/fomo/setAlertPreferences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"preferences":"<preferences>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fomo.setAlertPreferences("<preferences>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/fomo/<function> - OpenAPI
/v1/sites/fomo/openapi.json