@tapline/client 0.2.16 → 0.2.18

package/dist/cjs/services/pumpfun/types.d.ts

@@ -279,6 +279,7 @@ export interface Callout {
     xUsername: string | null;
     xFollowerCount: number;
     accountKind?: string;
+    prediction?: null;
 }
 export interface CalloutAuthor {
     userId: string;
@@ -371,8 +372,6 @@ export interface ChainCandlesParams {
     to?: number | null;
     /** Bars ending at `to`. */
     count?: number;
-    /** One pool of the coin. Omit to stitch curve and AMM bars together. */
-    pool?: string | null;
 }
 export interface ChainPriceLineParams {
     /** Chain the coin trades on; `hypercore` for HyperCore perps. */
@@ -454,7 +453,7 @@ export interface ClipsById {
     thumbnailUrl: string;
     thumbnailS3Key: string;
     playlistS3Key: string;
-    title?: string;
+    title?: string | null;
     hidden: boolean;
     clipType: string;
     createdAt: string;
@@ -579,6 +578,7 @@ export interface CoinHolderPnlParams {
     /** Solana mint address. pump.fun refuses EVM tokens here. */
     mint: string;
 }
+export type CoinListSort = "created_timestamp" | "market_cap" | "ath_market_cap" | "last_trade_timestamp";
 export interface CoinMayhemState {
     mint: string;
     state: string;
@@ -586,11 +586,20 @@ export interface CoinMayhemState {
     multiplayer?: boolean;
     pause_reason?: string;
     complete_reason?: string;
+    first_trade_quote_amount?: string;
+    stats?: CoinMayhemStats;
 }
 export interface CoinMayhemStateParams {
     /** Token mint address. */
     mint: string;
 }
+export interface CoinMayhemStats {
+    buyCount: number;
+    sellCount: number;
+    totalBuyVolumeSol: string;
+    totalSellVolumeSol: string;
+    netSolDeployed: string;
+}
 export interface CoinNarrativesParams {
     /** Maximum narratives to return. */
     limit?: number;
@@ -622,7 +631,7 @@ export interface CoinPosition {
     totalCallouts: number;
     amountHeld: number;
     valueUsd: number | null;
-    pnlUsd: number;
+    pnlUsd: number | null;
     pnlPercentage: number | string | null;
     realizedPnlUsd: number;
     tokenPriceUsd: number | null;
@@ -657,8 +666,6 @@ export interface CoinTopCalloutsParams {
     mint: string;
     /** Maximum callouts to return. */
     limit?: number;
-    /** Chain of the coin, to pin an EVM token. */
-    chain?: TokenChain | null;
 }
 export interface CoinsBatch {
     mint: string;
@@ -748,7 +755,7 @@ export interface CoinsParams {
     /** Maximum coins to return. pump.fun serves 70 at most. */
     limit?: number;
     /** Ranking column. */
-    sort?: CoinSort;
+    sort?: CoinListSort;
     /** Sort direction. */
     order?: CoinSortDirection;
     /** Include coins flagged not-safe-for-work. */
@@ -1451,42 +1458,9 @@ export interface GetCoinTimelineResponseItem {
     recipients?: ItemRecipient[];
 }
 export interface GetCoinTopCalloutsResponse {
-    callouts: GetCoinTopCalloutsResponseCallout[];
-}
-export interface GetCoinTopCalloutsResponseCallout {
-    calloutId: string;
-    userId: string;
-    coinMint: string;
-    marketCap: number;
-    calloutPrice: number;
-    calloutPriceUsd?: number;
-    multiple: number;
-    createdAt: number;
-    maxPriceSol: number;
-    maxPriceUsd?: number;
-    thesis: string;
-    user_uuid: string;
-    likes?: number;
-    hasLiked?: null;
-    hasReposted?: null;
-    repostCount?: number;
-    quoteCount?: number;
-    updates?: unknown[];
-    updateCount?: number;
-    commentCount?: number;
-    replyCount?: number;
-    maxMultiplier?: number;
-    maxMultiplierAt?: string;
-    mediaUrl?: string | null;
-    quotedCalloutId?: null;
-    quotedCallout?: null;
-    chain?: string | null;
-    perp?: null;
-    peakTimestamp?: number;
-    username?: string;
-    profileImage?: string;
-    xUsername?: string | null;
-    isVerified?: boolean;
+    callouts: GetMintPositionsResponsePosition[];
+    totalCount: number;
+    hasMore?: boolean;
 }
 export interface GetCompetitionEntryHighlightsResponse {
     entryId: string;
@@ -1861,10 +1835,10 @@ export interface GetMintPositionsResponsePosition {
     accountKind?: string;
     amountHeld: number;
     pnlUsd: number;
-    pnlPercentage: number;
+    pnlPercentage: number | null;
     realizedPnlUsd: number;
     costBasisAmount: number;
-    costBasisUsd: number;
+    costBasisUsd: number | null;
     amountBoughtUsd: number;
     amountBought: number;
     callout: PositionCallout | null;
@@ -2030,7 +2004,7 @@ export interface GetPerpTradesResponseTrade {
     quotePriceUsd: string | null;
     valueUsd: string;
     valueNative: string | null;
-    coin: Pool;
+    coin: Pool | null;
     perp?: Perp;
 }
 export interface GetPlaylistMapResponse {
@@ -2076,6 +2050,48 @@ export interface GetPnlLeaderboardResponse {
     periodLabel: string;
     windowStartSec: number;
 }
+export interface GetPoolStatsResponse {
+    poolAddress: string;
+    totalQuoteReservesUsd?: number;
+    createdAt: number;
+    fee: number | null;
+    liquidity: string;
+    liquidityToken: string;
+    nonLiquidityToken: string;
+    price: string;
+    priceNonQuoteToken: string;
+    quoteToken: string;
+    highPrice5m: string | null;
+    highPrice1: string | null;
+    highPrice4: string | null;
+    highPrice12: string | null;
+    highPrice24: string | null;
+    lowPrice5m?: string | null;
+    lowPrice1: string | null;
+    lowPrice4: string | null;
+    lowPrice12: string | null;
+    lowPrice24: string | null;
+    priceChange5m: number | null;
+    priceChange1: number | null;
+    priceChange4: number | null;
+    priceChange12: number | null;
+    priceChange24: number | null;
+    volume5m: string;
+    volume1: string;
+    volume4: string;
+    volume12: string;
+    volume24: string;
+    bundlerCount: number | null;
+    bundlerHeldPercentage: number | null;
+    devHeldPercentage: number | null;
+    insiderCount: number | null;
+    insiderHeldPercentage: number | null;
+    sniperCount: number | null;
+    sniperHeldPercentage: number | null;
+    token0: PoolToken;
+    token1: PoolToken;
+    isFallback?: boolean;
+}
 export interface GetPortfolioSummaryResponse {
     wallet: string;
     from: number;
@@ -2177,6 +2193,9 @@ export interface GetTokenHolderCountResponse {
     networkId: number;
     holderCount: number;
 }
+export interface GetTokenMetadataBatchResponse {
+    tokens: MultichainToken[];
+}
 export interface GetTopTokenMintChainsResponse {
     mints: string[];
     chains: Record<string, string[]>;
@@ -2293,6 +2312,7 @@ export interface GetUserCalloutsResponseCallout {
     tailAthHist4h?: TailHistogram | null;
     tailAthHist24h?: TailHistogram | null;
     author?: CalloutAuthor;
+    prediction?: null;
 }
 export interface GetUserCoinCalloutResponse {
     callout: GetUserCalloutsResponseCallout | null;
@@ -2453,6 +2473,7 @@ export interface GetUserPositionsResponsePosition {
     realizedPnlUsd: number;
     updatedAt: string;
     lastSlotIndexId?: string;
+    tradeCount?: number;
 }
 export interface GetUserRepostsResponse {
     reposts: Repost[];
@@ -2752,6 +2773,7 @@ export interface HoldingCallout {
     viewCount: number;
     quotedCalloutId: null;
     quotedCallout: null;
+    prediction?: null;
 }
 export interface HomeFeedLegacyPosition {
     userId: string;
@@ -3117,8 +3139,8 @@ export interface Livestream {
     numParticipants: number;
     maxParticipants: number;
     isLive: boolean;
-    thumbnail: string;
-    thumbnailUpdatedAt: number;
+    thumbnail?: string;
+    thumbnailUpdatedAt?: number;
     downrankScore: number;
     title: string;
     mode: string;
@@ -3393,6 +3415,50 @@ export interface MultiChainBreakdown {
     optimism?: Solana;
     sei?: Solana;
 }
+export interface MultichainToken {
+    address: string;
+    poolAddress: string | null;
+    totalSupply: string | null;
+    circulatingSupply: string | null;
+    chain: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    imageUri: string | null;
+    highResImageUri: string | null;
+    bannerImageUri: string | null;
+    videoUri: string | null;
+    description: string | null;
+    launchpad: string | null;
+    launchpadProgram: string | null;
+    twitter: string | null;
+    telegram: string | null;
+    discord: string | null;
+    website: string | null;
+    instagram: string | null;
+    facebook: string | null;
+    email: string | null;
+    other: Record<string, string>;
+    creatorAddress: string | null;
+    createTransactionHash: string | null;
+    createdAt: number | null;
+    migrationCompleted: boolean | null;
+    migratedAt: number | null;
+    migratedPoolAddress: string | null;
+    nonMajorPoolSelected: boolean | null;
+    potentialScamReasons: unknown[] | null;
+    isValidated: boolean;
+    operatorBypass: boolean;
+    operatorBlacklist: boolean;
+    operatorWarning: null;
+    isHolderReward?: boolean;
+    assetClass: string | null;
+    issuer: string | null;
+    canonicalStock: boolean | null;
+    underlyingSymbol: string | null;
+    imageBackdrop?: string | null;
+}
+export type MultichainTokenChain = "solana" | "base" | "bsc" | "ethereum" | "monad" | "robinhood" | "hyperevm" | "ink" | "arc" | "megaeth" | "xlayer" | "polygon" | "arbitrum" | "avalanche" | "optimism" | "sei";
 export type NarrativeSource = "trending" | "movers" | "new";
 export interface Nativeasset {
     chainId: string;
@@ -3573,7 +3639,7 @@ export interface Playback {
     hlsUrl: string;
 }
 export interface PlaylistMapRequest {
-    /** Token mint addresses, at least one. */
+    /** Token mint addresses, 1 to 500. */
     mints: string[];
 }
 export interface PnlLeaderboardParams {
@@ -3604,6 +3670,26 @@ export interface Pool {
     chainId: string;
     address: string;
 }
+export interface PoolStatsParams {
+    /** Chain the pool trades on. */
+    chain: MultichainTokenChain;
+    /** Pool address: a base58 address on Solana; on an EVM chain a 0x pair address, or a 32-byte 0x pool id for Uniswap v4 pools. `poolAddress` on `/tokens/batch`. */
+    pool: string;
+    /** Token the pool is read for. On Solana pump.fun then answers that token's main pool whatever `pool` says; EVM chains ignore it. */
+    token_address?: string | null;
+}
+export interface PoolToken {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: string;
+    circulatingSupply: string;
+    price: string;
+    pooled: string;
+    isScam: null;
+    createdAt: number;
+}
 export type PortfolioFilter = "OPEN" | "CLOSED" | "ALL";
 export type PortfolioPeriod = "1d" | "1w" | "1m" | "all";
 export type PortfolioSort = "POSITION_SIZE" | "RECENCY" | "PNL";
@@ -3670,6 +3756,8 @@ export interface PositionCallout {
     quotedCallout: null;
     actingUserId?: null;
     actingUser?: null;
+    prediction?: null;
+    pinnedUpdate?: Update;
 }
 export interface PositionCoin {
     name: string | null;
@@ -3837,6 +3925,7 @@ export interface Reply {
     positionAvgEntryMcapUsd: number | null;
     isQuote: boolean;
     viewCount?: number;
+    prediction?: null;
 }
 export type ReplyFilter = "ALL" | "EXCLUDE_AUTHOR" | "AUTHOR_ONLY";
 export interface ReplyLikersParams {
@@ -4288,7 +4377,7 @@ export interface SimilarCoinResult {
     quote_mint?: string;
     base_decimals: number;
     quote_decimals?: number;
-    pool_address: string;
+    pool_address?: string;
     chain_id: string;
     multichain_family: number;
     protocol: string;
@@ -4456,6 +4545,12 @@ export interface TokenMember {
     unrealizedPnlUsd: number;
     buySpendUsd: number;
 }
+export interface TokenMetadataBatchRequest {
+    /** Token addresses (Solana mints or EVM tokens) on any mix of chains, 1 to 50. EVM addresses come back lowercased; addresses pump.fun cannot resolve are left out. */
+    addresses: string[];
+    /** Look every address up on this chain and leave out those not on it. Omit to let pump.fun pick each address's chain. */
+    chain?: MultichainTokenChain | null;
+}
 export interface Tokenpnl {
     cost_basis_usd: number | null;
     unrealized_usd: number | null;
@@ -4638,15 +4733,15 @@ export interface TrendingCoin {
     mint: string;
     chain?: string;
     initialized?: boolean;
-    name: string;
-    symbol: string;
-    image_uri: string;
+    name?: string;
+    symbol?: string;
+    image_uri?: string;
     metadata_uri?: string;
     twitter?: string;
     bonding_curve?: string;
     associated_bonding_curve?: string;
     creator?: string;
-    created_timestamp: number;
+    created_timestamp?: number;
     complete?: boolean;
     virtual_sol_reserves?: number;
     virtual_token_reserves?: number;
@@ -4655,9 +4750,9 @@ export interface TrendingCoin {
     show_name?: boolean;
     last_trade_timestamp?: number;
     market_cap?: number;
-    nsfw: boolean;
+    nsfw?: boolean;
     inverted?: boolean;
-    is_banned: boolean;
+    is_banned?: boolean;
     pump_swap_pool?: string;
     real_sol_reserves?: number;
     real_token_reserves?: number;
@@ -4680,7 +4775,7 @@ export interface TrendingCoin {
     protocol?: string;
     volume_24h_usd?: number;
     price_change_24h_bps?: number;
-    total_supply_str: string;
+    total_supply_str?: string;
     market_cap_usd?: number;
     virtual_quote_reserves?: number;
     real_quote_reserves?: number;
@@ -4802,8 +4897,6 @@ export interface UserCoinCalloutParams {
     address: string;
     /** Token mint address. */
     mint: string;
-    /** Quote posts of the callout to include. */
-    quotes_limit?: number | null;
 }
 export interface UserCreatedCoinsParams {
     /** Wallet address, Solana or EVM (0x). */