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.

Functions
54
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just fomo

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/fomo
Every site

One MCP server for fomo and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 51
  • filterTokensThe full token screener, a POST taking the site's own filter object and returning matching tokens with their market numbers.

    Arguments

    NameTypeRequired
    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/filterTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getAlertPreferences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getAlertPreferences();
  • getBalancesReturns what one trader actually holds.

    Arguments

    NameTypeRequired
    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/getBalances

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getBalances("user123");
  • getCandlesReturns OHLCV bars for one token.

    Arguments

    NameTypeRequired
    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/getCandles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    clanIdstringYes
    windowFomoLeaderboardWindowNo
    type FomoLeaderboardWindow = "daily" | "weekly" | "monthly" | "allTime";

    Returns FomoClan

    type 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/getClan

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getClan("clan123");
  • getClanFeedPages a clan's own feed and the theses its members have written.

    Arguments

    NameTypeRequired
    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/getClanFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getClanFeed("clan123");
  • getClanHoldingsReturns what a clan collectively holds.

    Arguments

    NameTypeRequired
    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/getClanHoldings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getClanHoldings("clan123");
  • getClanHoldingsBreakdownBreaks one clan's position in ONE token down to the members holding it.

    Arguments

    NameTypeRequired
    clanIdstringYes
    addressstringYes
    chainFomoChainSlug | numberYes
    type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";

    Returns unknown[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getClanHoldingsBreakdown

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getClanHoldingsBreakdown("clan123", "0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");
  • getClanThesisThe written theses a clan's members have posted.

    Arguments

    NameTypeRequired
    clanIdstringYes
    limitnumberNo

    Returns unknown[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getClanThesis

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getClanThesis("clan123");
  • getCurrentUserReturns the signed-in trader's own profile.

    Arguments

    None.

    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/getCurrentUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getCurrentUser();
  • getDevHoldersReturns whether the token's own deployer still holds it, and how much.

    Arguments

    NameTypeRequired
    addressstringYes
    chainFomoChainSlug | numberYes
    type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";

    Returns unknown[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getDevHolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getDevHolders("So11111111111111111111111111111111111111112", "solana");
  • getFeedPages the signed-in trader's social feed.

    Arguments

    NameTypeRequired
    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/getFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getFeed();
  • getFollowersPages the traders following one user, newest first, with full profiles.

    Arguments

    NameTypeRequired
    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/getFollowers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getFollowers("user123");
  • getFollowingPages the traders one user follows, newest first, with full profiles.

    Arguments

    NameTypeRequired
    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/getFollowing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getFollowingIds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getFollowingLeaderboard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getFollowingLeaderboard();
  • getFriendHoldersReturns which of the signed-in trader's own follows hold a given token.

    Arguments

    NameTypeRequired
    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/getFriendHolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getGraduatedTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getGraduatedTokens();
  • getLeaderboardReturns the ranked traders for one window.

    Arguments

    NameTypeRequired
    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/getLeaderboard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getMajorTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getMostHeldTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getMostHeldTokens();
  • getMutualsPages the traders both the signed-in user and another user follow.

    Arguments

    NameTypeRequired
    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/getMutuals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getMutuals("user123");
  • getPortfolioHistoryReturns the time series behind a trader's portfolio-value chart.

    Arguments

    NameTypeRequired
    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/getPortfolioHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getPortfolioHistory("user123");
  • getPortfolioSnapshotReturns one point of that series in full.

    Arguments

    NameTypeRequired
    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/getPortfolioSnapshot

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getPortfolioSnapshot("user123", "snap123");
  • getRecommendedUsersReturns fomo's own suggestions of traders to follow for one user.

    Arguments

    NameTypeRequired
    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/getRecommendedUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    userIdstringYes
    cursorstringNo

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getReferrals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getReferrals("<userId>");
  • getReferrerDetailsReturns who referred the signed-in trader, and the terms attached.

    Arguments

    NameTypeRequired
    userIdstringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getReferrerDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getReferrerDetails("<userId>");
  • getTokenReturns one token's full detail.

    Arguments

    NameTypeRequired
    addressstringYes
    chainFomoChainSlug | numberYes
    type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";

    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/getToken

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getTokenAllowlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getTokenAllowlistDetailed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTokenAllowlistDetailed();
  • getTokenFeedPages all trades for one token.

    Arguments

    NameTypeRequired
    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/getTokenFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    addressstringYes
    chainstringYes

    Returns unknown[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getTokenThesis

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTokenThesis("0xdac17f958d2ee523a2206206994597c13d831ec7", "ethereum");
  • getTokenWarningsReturns fomo's risk flags for one token.

    Arguments

    NameTypeRequired
    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/getTokenWarnings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/getTopHolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTopHolders([
      {
        address: "So11111111111111111111111111111111111111112",
        chain: "solana"
      }
    ]);
  • getTradeReturns one trade in full by id, with its author and token.

    Arguments

    NameTypeRequired
    tradeIdstringYes

    Returns 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;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getTrade

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTrade("trade123");
  • getTradeCommentsReturns the comment thread under one trade, in the site's own order.

    Arguments

    NameTypeRequired
    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/getTradeComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTradeComments("trade123");
  • getTradesPages trades across the platform, optionally filtered to one trader by userId.

    Arguments

    NameTypeRequired
    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/getTrades

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTrades();
  • getTradingActivityFeedPages raw trading activity rather than the composed social feed.

    Arguments

    NameTypeRequired
    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/getTradingActivityFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getTrendingTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getTrendingTokens();
  • getUserReturns one trader's public profile by fomo user id.

    Arguments

    NameTypeRequired
    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/getUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUser("user123");
  • getUserByHandleReturns one trader's profile from their @handle.

    Arguments

    NameTypeRequired
    handlestringYes

    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/getUserByHandle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUserByHandle("somehandle");
  • getUserLeaderboardStandingReturns one trader's own rank and stats without walking the board.

    Arguments

    NameTypeRequired
    userIdstringYes

    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/getUserLeaderboardStanding

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUserLeaderboardStanding("user123");
  • getUserSpotlightReturns the highlighted trades and stats fomo pins to the top of one trader's profile.

    Arguments

    NameTypeRequired
    userIdstringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/getUserSpotlight

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUserSpotlight("user123");
  • getUserSwapsPages one trader's own executed swaps.

    Arguments

    NameTypeRequired
    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/getUserSwaps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUserSwaps("user123");
  • getUserTransfersPages one trader's token transfers in and out.

    Arguments

    NameTypeRequired
    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/getUserTransfers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getUserTransfers("user123");
  • getUserWithdrawalsReturns one trader's withdrawals off the platform for a given chain.

    Arguments

    NameTypeRequired
    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/getUserWithdrawals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getVerifiedTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.getWatchlist();
  • searchClansSearches clans by name.

    Arguments

    NameTypeRequired
    searchTermstringYes

    Returns FomoClanRef[]

    interface FomoClanRef {
      id: string;
      name: string;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/searchClans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.searchClans("test");
  • searchTokensSearches tokens by name, symbol or contract address and returns matching rows with their market numbers.

    Arguments

    NameTypeRequired
    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/searchTokens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.searchTokens("sol");
  • searchUsersFuzzy-searches traders by handle or display name and returns matching profiles.

    Arguments

    NameTypeRequired
    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/searchUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.searchUsers("test");
Act 3
  • addToWatchlistAdds a token to the signed-in trader's watchlist.

    Arguments

    NameTypeRequired
    addressstringYes
    chainFomoChainSlug | numberYes
    type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";

    Returns FomoWatchlistChange

    interface FomoWatchlistChange {
      watching: boolean;
      tokenAddress: string;
      networkId: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/addToWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.addToWatchlist("<address>", "<chain>");
  • removeFromWatchlistRemoves a token from the signed-in trader's watchlist.

    Arguments

    NameTypeRequired
    addressstringYes
    chainFomoChainSlug | numberYes
    type FomoChainSlug = "solana" | "base" | "bnb" | "ethereum" | "monad";

    Returns FomoWatchlistChange

    interface FomoWatchlistChange {
      watching: boolean;
      tokenAddress: string;
      networkId: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/removeFromWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.removeFromWatchlist("<address>", "<chain>");
  • setAlertPreferencesWrites the signed-in trader's push-notification preferences.

    Arguments

    NameTypeRequired
    preferencesunknownYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fomo/setAlertPreferences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fomo.setAlertPreferences("<preferences>");

Use it from code