# pump.fun Data API > pump.fun market and social trading data: coin overview and stats, top holders with usernames and P&L, top traders, trade tape, candles, trending and live boards, search, the P&L leaderboard and trader profiles with portfolios. Every /v1 route costs one x402 micropayment. ## Documentation - [OpenAPI](https://pump.x4o2.com/openapi.json): Machine-readable route definitions - [Complete documentation](https://pump.x4o2.com/llms-full.txt): Parameters, schemas and captured examples - [API keys](https://x4o2.com/keys): Free access - [30-day pass](https://x4o2.com/pass): Higher limits ## Access and limits Free API key: https://x4o2.com/keys; Authorization: Bearer x4o2_… . Free access allows 60/minute and 1000/UTC day per service while spare capacity is available. 30-day pass: 10 USDC, 300/minute and 10000/UTC day per service, independent of free-tier pauses. POST https://x4o2.com/v1/pass with x402. Renewal extends from the later of expiry or purchase time. Wallet signing retrieves a replacement key at https://x4o2.com/pass; previous keys are revoked. Refunds are handled manually. x402: request without payment to receive a v2 PAYMENT-REQUIRED challenge; sign one accepted Base or Solana USDC option, retry with PAYMENT-SIGNATURE. PAYMENT-RESPONSE contains the settlement receipt. Failed calls are not settled. Counters reset on service restart. Pass expiry is enforced even when the key verifier is cached. Errors: 400 invalid/unknown parameters; 401 invalid or expired key; 402 payment required or verification failed; 409 payment in flight/replayed; 429 minute_quota_exceeded, daily_quota_exceeded, free_tier_paused (Retry-After); 502 upstream error; 503 busy/unavailable. RateLimit-* and X-RateLimit-* describe key quotas. ## Usage All routes are GET and cost 0.001 USDC per call via x402 on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp); an unpaid request returns 402 with payment requirements. Identify a coin by its Solana mint address. Use GET /v1/coins/search?q= to resolve a name or ticker to a mint. Start with GET /v1/coin/{mint} for metadata, market cap, buy/sell stats, ATH and holder count. Use /holders for the largest positions with usernames and P&L, /traders for who profited most and their trades, /trades for the live tape, /candles for OHLCV. Use /v1/coins/trending, /v1/coins/feed, /v1/coins/live and /v1/coins for discovery, /v1/leaderboard for the best-performing wallets. Use GET /v1/user/{wallet} (include=portfolio,summary,balance,created,followers,following,achievements) to evaluate a trader. EVM addresses for many wallets: GET /v1/users?wallets=... (up to 100 per call) or /v1/leaderboard?include=evm; the leaderboard is the top 100 per period (daily, weekly, monthly), no paging, no all-time board, no per-wallet rank lookup. Only the documented query parameters are accepted; an unknown one is a 400 unknown_parameter, not charged. Responses are { data, meta }; meta.observedAt and meta.source tell how fresh the data is. Pass maxAge= to require fresher data or stale=1 to accept any cached copy instantly. ## Endpoints - [GET /v1/coin/{mint}](https://pump.x4o2.com/v1/coin/{mint}): pump.fun coin overview: metadata, market cap, price, volume, buy/sell stats, ATH, holder count (0.001 USD via x402) One pump.fun coin in full: its metadata and bonding-curve/AMM state (coins-v3), the live indexer row (market cap, volume, dev wallet, program, creation time), trading activity windows (5m/1h/6h/24h transactions, volume, buyers and sellers, price change), all-time-high market cap and holder count. Use for a quantitative read on a pump.fun token. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Token mint address (base58)" }, "description": "Token mint address (base58)", "example": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "coin": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "initialized": { "type": [ "boolean", "null" ] }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "image_uri": { "type": [ "string", "null" ] }, "bonding_curve": { "type": [ "string", "null" ] }, "associated_bonding_curve": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "created_timestamp": { "type": [ "number", "null" ] }, "complete": { "type": [ "boolean", "null" ] }, "virtual_sol_reserves": { "type": [ "number", "null" ] }, "virtual_token_reserves": { "type": [ "number", "null" ] }, "total_supply": { "type": [ "number", "null" ] }, "show_name": { "type": [ "boolean", "null" ] }, "last_trade_timestamp": { "type": [ "number", "null" ] }, "market_cap": { "type": [ "number", "null" ] }, "nsfw": { "type": [ "boolean", "null" ] }, "inverted": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "pump_swap_pool": { "type": [ "string", "null" ] }, "real_sol_reserves": { "type": [ "number", "null" ] }, "real_token_reserves": { "type": [ "number", "null" ] }, "updated_at": { "type": [ "number", "null" ] }, "livestream_ban_expiry": { "type": [ "number", "null" ] }, "reply_count": { "type": [ "number", "null" ] }, "is_currently_live": { "type": [ "boolean", "null" ] }, "ath_market_cap": { "type": [ "number", "null" ] }, "ath_market_cap_timestamp": { "type": [ "number", "null" ] }, "hide_banner": { "type": [ "boolean", "null" ] }, "program": { "type": [ "string", "null" ] }, "token_program": { "type": [ "string", "null" ] }, "quote_mint": { "type": [ "string", "null" ] }, "base_decimals": { "type": [ "number", "null" ] }, "quote_decimals": { "type": [ "number", "null" ] }, "pool_address": { "type": [ "string", "null" ] }, "is_cashback_enabled": { "type": [ "boolean", "null" ] }, "chain_id": { "type": [ "string", "null" ] }, "multichain_family": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "total_supply_str": { "type": [ "string", "null" ] }, "market_cap_usd": { "type": [ "number", "null" ] }, "virtual_quote_reserves": { "type": [ "number", "null" ] }, "real_quote_reserves": { "type": [ "number", "null" ] }, "market_cap_quote": { "type": [ "number", "null" ] }, "boost_mode": { "type": [ "string", "null" ] }, "verified": { "type": [ "boolean", "null" ] }, "is_holder_reward": { "type": [ "boolean", "null" ] }, "depth": { "type": [ "number", "null" ] }, "security_verdict": { "type": [ "object", "null" ], "properties": { "verdict": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "reasons": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "decided_by": { "type": [ "string", "null" ] }, "provider": { "type": [ "string", "null" ] }, "version": { "type": [ "number", "null" ] }, "updated_at": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] } } }, "usd_market_cap": { "type": [ "number", "null" ] }, "volume_1h_usd": { "type": [ "number", "null" ] }, "canonical_pool_liquidity_usd": { "type": [ "number", "null" ] }, "circulating_supply_str": { "type": [ "string", "null" ] }, "source": { "type": [ "string", "null" ] }, "price_usd": { "type": [ "number", "null" ] } } }, "indexer": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "chain": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "ticker": { "type": [ "string", "null" ] }, "dev": { "type": [ "string", "null" ] }, "program": { "type": [ "string", "null" ] }, "platform": { "type": [ "string", "null" ] }, "creationTime": { "type": [ "number", "null" ] }, "pair": { "type": [ "string", "null" ] }, "marketCapUsd": { "type": [ "number", "null" ] }, "volumeSol": { "type": [ "number", "null" ] }, "volumeUsd": { "type": [ "number", "null" ] }, "progress": { "type": [ "number", "null" ] }, "graduationDate": { "type": [ "number", "null" ] }, "athMarketCapUsd": { "type": [ "number", "null" ] }, "currentMarketPrice": { "type": [ "number", "null" ] }, "sniperCount": { "type": [ "number", "null" ] }, "numKolsTraded": { "type": [ "number", "null" ] }, "txCount": { "type": [ "number", "null" ] }, "buyCount": { "type": [ "number", "null" ] }, "sellCount": { "type": [ "number", "null" ] }, "priorityFeeSol": { "type": [ "number", "null" ] }, "priorityFeeUsd": { "type": [ "number", "null" ] }, "builderTipSol": { "type": [ "number", "null" ] }, "builderTipUsd": { "type": [ "number", "null" ] }, "tradingAppFeeSol": { "type": [ "number", "null" ] }, "tradingAppFeeUsd": { "type": [ "number", "null" ] }, "builderTipSolV2": { "type": [ "number", "null" ] }, "builderTipUsdV2": { "type": [ "number", "null" ] }, "tradingAppFeeSolV2": { "type": [ "number", "null" ] }, "tradingAppFeeUsdV2": { "type": [ "number", "null" ] }, "txFeeSolV2": { "type": [ "number", "null" ] }, "txFeeUsdV2": { "type": [ "number", "null" ] }, "feeSeedSol": { "type": [ "number", "null" ] }, "feeSeedUsd": { "type": [ "number", "null" ] }, "isMayhemMode": { "type": [ "boolean", "null" ] }, "mayhemState": {}, "mayhemMode": {}, "isMultiplayer": { "type": [ "boolean", "null" ] }, "mayhemBotCoinSupplied": { "type": [ "number", "null" ] }, "isCashbackEnabled": { "type": [ "boolean", "null" ] }, "isHolderReward": { "type": [ "boolean", "null" ] }, "isCurrentlyLive": { "type": [ "boolean", "null" ] }, "numLiveParticipants": { "type": [ "number", "null" ] }, "isCharity": { "type": [ "boolean", "null" ] }, "isNsfw": { "type": [ "boolean", "null" ] }, "isBanned": { "type": [ "boolean", "null" ] }, "imageUrl": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "videoUri": { "type": [ "string", "null" ] }, "hasSocial": { "type": [ "boolean", "null" ] }, "hasTwitter": { "type": [ "boolean", "null" ] }, "hasWebsite": { "type": [ "boolean", "null" ] }, "hasTelegram": { "type": [ "boolean", "null" ] }, "twitterReuseCount": { "type": [ "number", "null" ] }, "telegramReuseCount": { "type": [ "number", "null" ] }, "websiteReuseCount": { "type": [ "number", "null" ] }, "numHolders": { "type": [ "number", "null" ] }, "top10HoldersPercent": { "type": [ "number", "null" ] }, "devHoldingsPercent": { "type": [ "number", "null" ] } } }, "activity": { "type": [ "object", "null" ], "properties": { "5m": { "type": [ "object", "null" ], "properties": { "numTxs": { "type": [ "number", "null" ] }, "volumeUSD": { "type": [ "number", "null" ] }, "numUsers": { "type": [ "number", "null" ] }, "numBuys": { "type": [ "number", "null" ] }, "numSells": { "type": [ "number", "null" ] }, "buyVolumeUSD": { "type": [ "number", "null" ] }, "sellVolumeUSD": { "type": [ "number", "null" ] }, "numBuyers": { "type": [ "number", "null" ] }, "numSellers": { "type": [ "number", "null" ] }, "priceChangePercent": { "type": [ "number", "null" ] } } }, "1h": { "type": [ "object", "null" ], "properties": { "numTxs": { "type": [ "number", "null" ] }, "volumeUSD": { "type": [ "number", "null" ] }, "numUsers": { "type": [ "number", "null" ] }, "numBuys": { "type": [ "number", "null" ] }, "numSells": { "type": [ "number", "null" ] }, "buyVolumeUSD": { "type": [ "number", "null" ] }, "sellVolumeUSD": { "type": [ "number", "null" ] }, "numBuyers": { "type": [ "number", "null" ] }, "numSellers": { "type": [ "number", "null" ] }, "priceChangePercent": { "type": [ "number", "null" ] } } }, "6h": { "type": [ "object", "null" ], "properties": { "numTxs": { "type": [ "number", "null" ] }, "volumeUSD": { "type": [ "number", "null" ] }, "numUsers": { "type": [ "number", "null" ] }, "numBuys": { "type": [ "number", "null" ] }, "numSells": { "type": [ "number", "null" ] }, "buyVolumeUSD": { "type": [ "number", "null" ] }, "sellVolumeUSD": { "type": [ "number", "null" ] }, "numBuyers": { "type": [ "number", "null" ] }, "numSellers": { "type": [ "number", "null" ] }, "priceChangePercent": { "type": [ "number", "null" ] } } }, "24h": { "type": [ "object", "null" ], "properties": { "numTxs": { "type": [ "number", "null" ] }, "volumeUSD": { "type": [ "number", "null" ] }, "numUsers": { "type": [ "number", "null" ] }, "numBuys": { "type": [ "number", "null" ] }, "numSells": { "type": [ "number", "null" ] }, "buyVolumeUSD": { "type": [ "number", "null" ] }, "sellVolumeUSD": { "type": [ "number", "null" ] }, "numBuyers": { "type": [ "number", "null" ] }, "numSellers": { "type": [ "number", "null" ] }, "priceChangePercent": { "type": [ "number", "null" ] } } } } }, "ath": { "type": [ "object", "null" ], "properties": { "athMarketCap": { "type": [ "number", "null" ] } } }, "holders": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "chain": { "type": [ "string", "null" ] }, "networkId": { "type": [ "number", "null" ] }, "holderCount": { "type": [ "number", "null" ] } } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "coin": { "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "initialized": true, "name": "Catecoin", "symbol": "CATE", "image_uri": "https://imagedelivery.net/WL1JOIJiM_NAChp6rtB6Cw/coin-image/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "bonding_curve": "3Sg92V4Mre9Apm7dJsM39B6vrAEVVErE1vBsZMKyUbxT", "associated_bonding_curve": "3jNo7eYYhLFrRXSpYEevBCYj8uJioA95sH1MujyB1GJk", "creator": "D9gQ6RhKEpnobPBUdWY5bPQt2p3zGk3iVz6ChpUi2ArA", "created_timestamp": 1785083078000, "complete": true, "virtual_sol_reserves": 114147489352, "virtual_token_reserves": 282003577203745, "total_supply": 1000000000000000, "show_name": true, "last_trade_timestamp": 1793068389000, "market_cap": 458272.57799251605, "nsfw": false, "inverted": true, "is_banned": false, "pump_swap_pool": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3", "real_sol_reserves": 0, "real_token_reserves": 0, "updated_at": 1793068390, "livestream_ban_expiry": 0, "reply_count": 0, "is_currently_live": false, "ath_market_cap": 130574324.57841259, "ath_market_cap_timestamp": 1789849765000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3", "is_cashback_enabled": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "pump", "total_supply_str": "1000000000000000", "market_cap_usd": 45980001.173868276, "virtual_quote_reserves": 114147489352, "real_quote_reserves": 0, "market_cap_quote": 458272.577992516, "boost_mode": "COMPLETED", "verified": true, "is_holder_reward": true, "depth": 0, "security_verdict": { "verdict": "allow", "scope": "all", "reasons": [ "operator_bypass" ], "decided_by": "bypass", "provider": "none", "version": 32, "updated_at": 1792979855356, "source": "token-trust" }, "usd_market_cap": 45980001.173868276, "volume_1h_usd": 20877.489175924282, "canonical_pool_liquidity_usd": 2412226.2185210525, "circulating_supply_str": "1000000000000000", "source": "indexed", "price_usd": 0.04598000117386827 }, "indexer": { "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chain": "solana:mainnet", "name": "Catecoin", "ticker": "CATE", "dev": "D9gQ6RhKEpnobPBUdWY5bPQt2p3zGk3iVz6ChpUi2ArA", "program": "pump_amm", "platform": "", "creationTime": 1785083078000, "pair": "SOL", "marketCapUsd": 45977619.03084679, "volumeSol": 2272550.49483257, "volumeUsd": 242173323.19418263, "progress": 100, "graduationDate": 1787625930000, "athMarketCapUsd": 130574324.57841259, "currentMarketPrice": 0, "sniperCount": 0, "numKolsTraded": 214, "txCount": 1623706, "buyCount": 1085010, "sellCount": 538696, "priorityFeeSol": 416.71786447590586, "priorityFeeUsd": 44158.48158163223, "builderTipSol": 0, "builderTipUsd": 0, "tradingAppFeeSol": 0, "tradingAppFeeUsd": 0, "builderTipSolV2": 257.2870349345208, "builderTipUsdV2": 27524.420016355867, "tradingAppFeeSolV2": 2577.4123927381847, "tradingAppFeeUsdV2": 273480.0940425271, "txFeeSolV2": 459.8607626011525, "txFeeUsdV2": 48858.59597202167, "feeSeedSol": 0, "feeSeedUsd": 0, "isMayhemMode": false, "mayhemState": null, "mayhemMode": null, "isMultiplayer": false, "mayhemBotCoinSupplied": 0, "isCashbackEnabled": false, "isHolderReward": true, "isCurrentlyLive": false, "numLiveParticipants": 0, "isCharity": false, "isNsfw": false, "isBanned": true, "imageUrl": "https://images.pump.fun/coin-image/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "description": "", "videoUri": "", "hasSocial": false, "hasTwitter": false, "hasWebsite": false, "hasTelegram": false, "twitterReuseCount": 0, "telegramReuseCount": 0, "websiteReuseCount": 0, "numHolders": 17709, "top10HoldersPercent": 14.5945, "devHoldingsPercent": 0, "snipersOwnedPercent": 0, "bundlerOwnedPercentageV2": 0, "coinCreatedSupply": 0, "lastRecommendedAt": 1793068387351, "totalFees": 3294.560190273858, "totalFeesUSD": 349863.11003090465 }, "activity": { "5m": { "numTxs": 9, "volumeUSD": 84.06403327871658, "numUsers": 9, "numBuys": 6, "numSells": 3, "buyVolumeUSD": 26.660152893851066, "sellVolumeUSD": 57.40388038486551, "numBuyers": 6, "numSellers": 3, "priceChangePercent": -0.010108381359660162 }, "1h": { "numTxs": 131, "volumeUSD": 20871.348758899097, "numUsers": 103, "numBuys": 59, "numSells": 72, "buyVolumeUSD": 13818.933638759267, "sellVolumeUSD": 7052.415120139831, "numBuyers": 42, "numSellers": 67, "priceChangePercent": 1.006129171775132 }, "6h": { "numTxs": 1523, "volumeUSD": 223698.596219801, "numUsers": 866, "numBuys": 894, "numSells": 629, "buyVolumeUSD": 110796.16166075492, "sellVolumeUSD": 112902.43455904609, "numBuyers": 535, "numSellers": 484, "priceChangePercent": -0.28185820942932915 }, "24h": { "numTxs": 10648, "volumeUSD": 1348377.060417696, "numUsers": 4058, "numBuys": 5642, "numSells": 5006, "buyVolumeUSD": 653888.1016047072, "sellVolumeUSD": 694488.9588129888, "numBuyers": 2775, "numSellers": 2951, "priceChangePercent": -6.755887651488777 } }, "ath": { "athMarketCap": 130574324.57841259 }, "holders": { "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chain": "solana", "networkId": 1399811149, "holderCount": 143692 } }, "meta": { "observedAt": 1793068417434, "ageMs": 89, "source": "fresh", "parts": { "coin": { "observedAt": 1793068417434, "source": "fresh" }, "indexer": { "observedAt": 1793068417434, "source": "fresh" }, "marketActivity": { "observedAt": 1793068417434, "source": "fresh" }, "ath": { "observedAt": 1793068417434, "source": "fresh" }, "holderCount": { "observedAt": 1793068417434, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coin/{mint}/holders](https://pump.x4o2.com/v1/coin/{mint}/holders): Top holders of a pump.fun coin with username, position size, cost basis and P&L (0.001 USD via x402) The largest positions in a coin as pump.fun tracks them: each holder's wallet, pump.fun username and profile, amount held, position value, cost basis, realized and unrealized P&L and whether they are the developer. Use for holder concentration and smart-money analysis of a token. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Token mint address (base58)" }, "description": "Token mint address (base58)", "example": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-100", "minimum": 1, "maximum": 100, "default": 50 }, "description": "Number of entries, 1-100", "example": "50" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "positions": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "coinMint": { "type": [ "string", "null" ] }, "chainId": { "type": [ "number", "null" ] }, "userId": { "type": [ "string", "null" ] }, "userName": { "type": [ "string", "null" ] }, "profileImage": { "type": [ "string", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "isVerified": { "type": [ "boolean", "null" ] }, "verifiedBadgeVisible": { "type": [ "boolean", "null" ] }, "resolvedAvatarDecoration": { "type": [ "string", "null" ] }, "xUsername": { "type": [ "string", "null" ] }, "accountKind": { "type": [ "string", "null" ] }, "amountHeld": { "type": [ "number", "null" ] }, "pnlUsd": { "type": [ "number", "null" ] }, "pnlPercentage": { "type": [ "number", "null" ] }, "realizedPnlUsd": { "type": [ "number", "null" ] }, "costBasisAmount": { "type": [ "number", "null" ] }, "costBasisUsd": { "type": [ "number", "null" ] }, "amountBoughtUsd": { "type": [ "number", "null" ] }, "amountBought": { "type": [ "number", "null" ] }, "callout": { "type": [ "object", "null" ], "properties": { "calloutId": { "type": [ "string", "null" ] }, "chain": {}, "assetClass": { "type": [ "string", "null" ] }, "perp": {}, "calledOutAtMcap": { "type": [ "number", "null" ] }, "multiple": { "type": [ "number", "null" ] }, "thesis": { "type": [ "string", "null" ] }, "mediaUrl": {}, "calloutTimestamp": { "type": [ "string", "null" ] }, "likes": { "type": [ "number", "null" ] }, "hasLiked": {}, "updates": { "type": [ "array", "null" ] }, "updateCount": { "type": [ "number", "null" ] }, "commentCount": { "type": [ "number", "null" ] }, "replyCount": { "type": [ "number", "null" ] }, "maxMultiplier": { "type": [ "number", "null" ] }, "maxMultiplierAt": { "type": [ "string", "null" ] }, "calloutPrice": { "type": [ "number", "null" ] }, "repostCount": { "type": [ "number", "null" ] }, "quoteCount": { "type": [ "number", "null" ] }, "hasReposted": {}, "viewCount": { "type": [ "number", "null" ] }, "quotedCalloutId": {}, "quotedCallout": {}, "actingUserId": {}, "actingUser": {} } }, "lowQuality": { "type": [ "boolean", "null" ] } } } }, "totalCount": { "type": [ "number", "null" ] }, "hasMore": { "type": [ "boolean", "null" ] } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "positions": [ { "coinMint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chainId": 1399811149, "userId": "aa653097-46b7-40f7-bc93-3b84d8787853", "userName": "latentfish83215", "profileImage": "https://socialimages.pump.fun/profile-images/aa653097-46b7-40f7-bc93-3b84d8787853/65d97c92-ae42-4f4b-99db-e15b5259e0dd", "walletAddress": "HDixbrzwwLXczhDBk1JVrurPQsuLE8FUKnW2pucSXN3o", "isVerified": false, "verifiedBadgeVisible": true, "resolvedAvatarDecoration": null, "xUsername": null, "accountKind": "person", "amountHeld": 27556090.807485, "pnlUsd": 1147871.471116057, "pnlPercentage": 821.878114296513, "realizedPnlUsd": 9286.993489819346, "costBasisAmount": 27556090.807485003, "costBasisUsd": 128378.96749972746, "amountBoughtUsd": 139664.44064501926, "amountBought": 33240544.88591601, "callout": { "calloutId": "8368348b-17eb-4c7b-8fc5-dd4272222480", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 44241137, "multiple": 1.001988700470244, "thesis": "LET THE GAMES BEGIN. CATE BOTTOM IN AND THE CATEVENGERS BOUTA WIN.", "mediaUrl": null, "calloutTimestamp": "2026-10-26T14:17:29.812Z", "likes": 13, "hasLiked": null, "updates": [], "updateCount": 0, "commentCount": 0, "replyCount": 0, "maxMultiplier": 1.0636944016247694, "maxMultiplierAt": "2026-10-26T15:27:31.979Z", "calloutPrice": 0.0458863647956, "repostCount": 2, "quoteCount": 0, "hasReposted": null, "viewCount": 11331, "quotedCalloutId": null, "quotedCallout": null, "actingUserId": null, "actingUser": null }, "lowQuality": false }, { "coinMint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chainId": 1399811149, "userId": "f779e161-0f93-49ec-b763-2142854fd005", "userName": "SossaDotKek", "profileImage": "https://socialimages.pump.fun/profile-images/2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ/1483b61e-df0d-4b93-a3d4-161...", "walletAddress": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": "epic", "xUsername": "GeoffO7", "accountKind": "person", "amountHeld": 20730476.396162, "pnlUsd": 466794.9566433995, "pnlPercentage": 95.98060767671657, "realizedPnlUsd": 0, "costBasisAmount": 20730476.39611597, "costBasisUsd": 486342.9894251824, "amountBoughtUsd": 356240.85633483774, "amountBought": 14413072.671784988, "callout": { "calloutId": "c80441e0-f76e-4bc6-8672-8419a9383529", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 27728837, "multiple": 1.5990467289586163, "thesis": "I'm back 100x the Cate", "mediaUrl": null, "calloutTimestamp": "2026-08-04T03:30:32.325Z", "likes": 607, "hasLiked": null, "updates": [ { "id": "fc033446-8e19-4ed3-a342-7ff7e03ab8ac", "content": "Join the tiktok live for a hot chip challenge by pickle and tristin, Cate community locking in \n\nhttps://vt.tiktok.co...", "createdAt": "2026-10-24T17:49:17.599Z", "likeCount": 9, "mediaUrl": null, "parentMessageId": null, "repostCount": 0, "viewCount": 2393 }, { "id": "56c30e12-5cf1-472c-8fea-1c66adf0603c", "content": "Cate baddies space join up \n\nhttps://x.com/i/spaces/1mxPaZyLXvVKN", "createdAt": "2026-10-24T16:17:36.218Z", "likeCount": 1, "mediaUrl": null, "parentMessageId": null, "repostCount": 0, "viewCount": 352 } ], "updateCount": 127, "commentCount": 84, "replyCount": 211, "maxMultiplier": 4.541219206305773, "maxMultiplierAt": "2026-09-19T20:29:33.664Z", "calloutPrice": 0.0287531428558, "repostCount": 30, "quoteCount": 0, "hasReposted": null, "viewCount": 583986, "quotedCalloutId": null, "quotedCallout": null, "actingUserId": null, "actingUser": null }, "lowQuality": false } ], "totalCount": 6278, "hasMore": true }, "meta": { "observedAt": 1793068417524, "ageMs": 131, "source": "fresh", "parts": { "positions": { "observedAt": 1793068417524, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coin/{mint}/traders](https://pump.x4o2.com/v1/coin/{mint}/traders): Top traders of a pump.fun coin by P&L, each with their trade history on it (0.001 USD via x402) pump.fun's top-trader leaderboard for one coin: the wallets and usernames with the highest profit on it, their realized and unrealized P&L, buy and sell totals, and the individual trades behind the number. Use to find who made money on a token and how. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Token mint address (base58)" }, "description": "Token mint address (base58)", "example": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "traders": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "userId": { "type": [ "string", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "profileImage": { "type": [ "string", "null" ] }, "isVerified": { "type": [ "boolean", "null" ] }, "verifiedBadgeVisible": { "type": [ "boolean", "null" ] }, "resolvedAvatarDecoration": { "type": [ "string", "null" ] }, "bestRank": { "type": [ "number", "null" ] }, "periods": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "tradingWallets": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "tradeCount": { "type": [ "number", "null" ] } } } }, "trades": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "tx": { "type": [ "string", "null" ] }, "isBuy": { "type": [ "boolean", "null" ] }, "timestamp": { "type": [ "string", "null" ] }, "amountUsd": { "type": [ "number", "null" ] }, "baseAmount": { "type": [ "number", "null" ] }, "priceUsd": { "type": [ "number", "null" ] }, "mint": { "type": [ "string", "null" ] }, "chainId": { "type": [ "number", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "userId": { "type": [ "string", "null" ] }, "slotIndexId": { "type": [ "string", "null" ] }, "amountSol": { "type": [ "number", "null" ] } } } }, "boardsBuiltAtMs": { "type": [ "number", "null" ] }, "generatedAtMs": { "type": [ "number", "null" ] }, "page": { "type": [ "object", "null" ], "properties": { "nextCursor": {}, "to": {}, "limit": { "type": [ "number", "null" ] } } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "traders": [ { "userId": "33b4317c-3a2f-4027-be28-34fe8db86494", "walletAddress": "9BMzTpSo4URse1oN666pmexhdjpU1vA5p7LtroCFQdLU", "username": "Aurelius", "profileImage": "https://socialimages.pump.fun/profile-images/33b4317c-3a2f-4027-be28-34fe8db86494/29feff3b-484e-4c04-b279-077efb6cabc9", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": "achievement:first-place", "bestRank": 1, "periods": [ "daily", "weekly" ], "tradingWallets": [ "9BMzTpSo4URse1oN666pmexhdjpU1vA5p7LtroCFQdLU" ], "tradeCount": 99 }, { "userId": "5e5004b9-cc17-44ea-b6f8-1413b2539281", "walletAddress": "EqE7raLmEHPQQUmjiiUgSM6nbbgtRGaHf7CKg56BzXFK", "username": "insidecalls", "profileImage": "https://socialimages.pump.fun/profile-images/EqE7raLmEHPQQUmjiiUgSM6nbbgtRGaHf7CKg56BzXFK/5465a392-f461-42aa-8f36-ee8...", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": null, "bestRank": 6, "periods": [ "daily" ], "tradingWallets": [ "EqE7raLmEHPQQUmjiiUgSM6nbbgtRGaHf7CKg56BzXFK" ], "tradeCount": 2 } ], "trades": [ { "tx": "4e2ymAQu8V4WL9QZ1FazvKhzfeSKd7FBpoqMwSBDb7HZfPoohVYmSPjGopvD4rgVuM7L7BvWwtjFchLhQwd8XTMu", "isBuy": false, "timestamp": "2026-10-26T15:52:19.000Z", "amountUsd": 9808.635289, "baseAmount": 207685.914646, "priceUsd": 0.04722821625009471, "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chainId": 1399811149, "walletAddress": "Hzvs4kQ3pSeVpPqFgiQLfgKS4tpTDyk3GmKT1k8BQPBm", "userId": "735a41c3-27e3-4f17-a3ac-e7f9b1281916", "slotIndexId": "00046172159500017100000201", "amountSol": 96.22672165058516 }, { "tx": "jXRJun5uqTgcrnWHVHxQYev2PgXUHpiSszpPXfU2GmZvAQvAoE7155U5AQgSo2kSzZW4svuuAkGKAoKLJcVVshm", "isBuy": false, "timestamp": "2026-10-26T15:35:26.000Z", "amountUsd": 3986.381573, "baseAmount": 83187.620365, "priceUsd": 0.04792037030881596, "mint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chainId": 1399811149, "walletAddress": "Hzvs4kQ3pSeVpPqFgiQLfgKS4tpTDyk3GmKT1k8BQPBm", "userId": "735a41c3-27e3-4f17-a3ac-e7f9b1281916", "slotIndexId": "00046171681000011400000201", "amountSol": 39.013400903740234 } ], "boardsBuiltAtMs": 1793068403030, "generatedAtMs": 1793068417699, "page": { "nextCursor": null, "to": null, "limit": 500 } }, "meta": { "observedAt": 1793068417657, "ageMs": 81, "source": "fresh", "parts": { "topTraders": { "observedAt": 1793068417657, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coin/{mint}/trades](https://pump.x4o2.com/v1/coin/{mint}/trades): Recent trades on a pump.fun coin: buyer/seller, SOL and USD size, price, signature (0.001 USD via x402) The coin's trade tape as pump.fun shows it: the most recent buys and sells with wallet (and username where known), token and SOL amounts, USD value, price and market cap at the time, slot and transaction signature. minUsd filters out dust. Use to see current flow in a token. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Token mint address (base58)" }, "description": "Token mint address (base58)", "example": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-200", "minimum": 1, "maximum": 200, "default": 100 }, "description": "Number of entries, 1-200", "example": "100" }, { "name": "minUsd", "in": "query", "required": false, "schema": { "type": "number", "description": "Minimum USD size of trades to include", "minimum": 0 }, "description": "Minimum USD size of trades to include", "example": "1" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "trades": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "ordinalKey": { "type": [ "string", "null" ] }, "blockId": { "type": [ "string", "null" ] }, "txIndex": { "type": [ "number", "null" ] }, "eventIndex": { "type": [ "number", "null" ] }, "blockTimeMs": { "type": [ "number", "null" ] }, "txId": { "type": [ "string", "null" ] }, "legIndex": { "type": [ "number", "null" ] }, "late": { "type": [ "boolean", "null" ] }, "isBackfill": { "type": [ "boolean", "null" ] }, "side": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "venue": { "type": [ "string", "null" ] }, "pool": { "type": [ "object", "null" ], "properties": { "chainId": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] } } }, "trader": { "type": [ "object", "null" ], "properties": { "address": { "type": [ "string", "null" ] } } }, "baseAmount": { "type": [ "object", "null" ], "properties": { "raw": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] } } }, "quoteAmount": { "type": [ "object", "null" ], "properties": { "raw": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] } } }, "quote": { "type": [ "object", "null" ], "properties": { "id": { "type": [ "string", "null" ] } } }, "priceUsd": { "type": [ "string", "null" ] }, "priceQuote": { "type": [ "string", "null" ] }, "quotePriceUsd": { "type": [ "string", "null" ] }, "valueUsd": { "type": [ "string", "null" ] }, "valueNative": { "type": [ "string", "null" ] } } } }, "aggregates": { "type": [ "object", "null" ], "properties": { "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "string", "null" ] }, "sellVolumeUsd": { "type": [ "string", "null" ] }, "netBase": { "type": [ "object", "null" ], "properties": { "raw": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] } } }, "asOf": { "type": [ "string", "null" ] } } }, "cursor": { "type": [ "string", "null" ] }, "source": { "type": [ "string", "null" ] } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "trades": [ { "ordinalKey": "461902558-329-5-1793068389000", "blockId": "461902558", "txIndex": 329, "eventIndex": 5, "blockTimeMs": 1793068389000, "txId": "tDm7fZH6iaMsN5fMCbyPuQswQT5w2WDEdUBCjBkKBSQGSQzj69VDiGQ43k31bfcv2skRVjSzENdSPFP5sU4BosP", "legIndex": 0, "late": false, "isBackfill": false, "side": "buy", "kind": "swap", "venue": "pump_amm", "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3" }, "trader": { "address": "8W5X1wFtYLUaKm9xVk7aNFYGDbDxoXVfchk79X6KfprV" }, "baseAmount": { "raw": "43440539", "decimals": 6 }, "quoteAmount": { "raw": "19967299", "decimals": 9 }, "quote": { "id": "So11111111111111111111111111111111111111112" }, "priceUsd": "0.045977619030846791", "priceQuote": "0.000458272577992515", "quotePriceUsd": "100.3281043615", "valueUsd": "2.003281257889274588", "valueNative": "0.019967299" }, { "ordinalKey": "461902377-59-503-1793068350000", "blockId": "461902377", "txIndex": 59, "eventIndex": 503, "blockTimeMs": 1793068350000, "txId": "5MXXEDcaHNFYBKyT82mukqyXq1KfP7Ar1edaYr2K4FEafeDidveNNJasLgLymFaJwjm868yoE3obiVRVfmNux4MS", "legIndex": 0, "late": false, "isBackfill": false, "side": "buy", "kind": "swap", "venue": "pump_amm", "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3" }, "trader": { "address": "pFYT2J6tUFAoMGevVCZUjviNvrDWWjQ2fGwMA226ZcR" }, "baseAmount": { "raw": "237599484", "decimals": 6 }, "quoteAmount": { "raw": "108883875", "decimals": 9 }, "quote": { "id": "So11111111111111111111111111111111111111112" }, "priceUsd": "0.04597370826318917", "priceQuote": "0.000458270616658584", "quotePriceUsd": "100.32000000000001", "valueUsd": "10.92323034", "valueNative": "0.108883875" } ], "aggregates": { "buys": 14, "sells": 6, "buyVolumeUsd": "688.124293943146", "sellVolumeUsd": "177.94605634291537", "netBase": { "raw": "11087954378", "decimals": 6 }, "asOf": "461902558-329-5-1793068389000" }, "cursor": "AQBEIcDM5Z2sgIhSNHuhAQAAGjAwMDQ2MTkwMjU1ODAwMDMyOTAwMDAwMDA1yLMpe6EBAAAaMDAwNDYxODk5MjkzMDAwMDQxMDAwMDA0MDOKk0ZgqEZElg", "source": "indexed" }, "meta": { "observedAt": 1793068417740, "ageMs": 161, "source": "fresh", "parts": { "trades": { "observedAt": 1793068417740, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coin/{mint}/candles](https://pump.x4o2.com/v1/coin/{mint}/candles): OHLCV candles for a pump.fun coin in USD or SOL, price or market cap (0.001 USD via x402) Historical candles for one coin from pump.fun's own chart data: open, high, low, close, USD volume and trade count per bucket. res picks the bucket (1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d), count how many of the most recent buckets, measure whether values are price or market cap in USD or SOL. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Token mint address (base58)" }, "description": "Token mint address (base58)", "example": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "res", "in": "query", "required": false, "schema": { "type": "string", "description": "Bucket size", "enum": [ "1m", "5m", "15m", "30m", "1h", "4h", "6h", "12h", "1d" ] }, "description": "Bucket size", "example": "5m" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of most recent buckets", "minimum": 1, "maximum": 1000 }, "description": "Number of most recent buckets", "example": "100" }, { "name": "measure", "in": "query", "required": false, "schema": { "type": "string", "description": "Whether values are price or market cap, in USD or SOL", "enum": [ "price_usd", "price_sol", "market_cap_usd", "market_cap_sol" ] }, "description": "Whether values are price or market cap, in USD or SOL", "example": "price_usd" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "candles": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "openTimeMs": { "type": [ "number", "null" ] }, "open": { "type": [ "string", "null" ] }, "high": { "type": [ "string", "null" ] }, "low": { "type": [ "string", "null" ] }, "close": { "type": [ "string", "null" ] }, "volumeUsd": { "type": [ "string", "null" ] }, "trades": { "type": [ "number", "null" ] }, "final": { "type": [ "boolean", "null" ] }, "isCorrection": { "type": [ "boolean", "null" ] }, "pool": { "type": [ "object", "null" ], "properties": { "chainId": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] } } } } } }, "hasOlder": { "type": [ "boolean", "null" ] }, "source": { "type": [ "string", "null" ] }, "served": { "type": [ "object", "null" ], "properties": { "res": { "type": [ "string", "null" ] }, "measure": { "type": [ "string", "null" ] } } }, "graduatedAt": { "type": [ "string", "null" ] }, "supplyUsed": { "type": [ "string", "null" ] }, "createdMs": { "type": [ "number", "null" ] } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "candles": [ { "openTimeMs": 1792983600000, "open": "0.049196079569612752", "high": "0.049438157393969744", "low": "0.047073698397580112", "close": "0.047709635860043155", "volumeUsd": "61086.205056812140910387", "trades": 443, "final": true, "isCorrection": false, "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3" } }, { "openTimeMs": 1792987200000, "open": "0.047709635860043155", "high": "0.049313957230704308", "low": "0.047705799825580879", "close": "0.049280557137040381", "volumeUsd": "35697.161289006274381868", "trades": 228, "final": true, "isCorrection": false, "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "HMzvsEEmtzHhvZNw9uwbaG85HCTmFnkbhzUx16cy7ca3" } } ], "hasOlder": true, "source": "indexed", "served": { "res": "1h", "measure": "price_usd" }, "graduatedAt": "435367528-231-5-1785083563000", "supplyUsed": "1000000000", "createdMs": 1785083078000 }, "meta": { "observedAt": 1793068417904, "ageMs": 128, "source": "fresh", "parts": { "candles": { "observedAt": 1793068417904, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coins/trending](https://pump.x4o2.com/v1/coins/trending): pump.fun trending board: the coins moving right now with market cap, volume and price change (0.001 USD via x402) pump.fun's live trending board (the 'movers' surface of its advanced indexer): mint, name, ticker, chain, market cap, volume, price changes, holder and transaction counts per coin, ordered as the site ranks them. Use to find what is active on pump.fun at this moment. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-150", "minimum": 1, "maximum": 150, "default": 50 }, "description": "Number of entries, 1-150", "example": "50" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "board": { "type": [ "string", "null" ] }, "version": { "type": [ "number", "null" ] }, "serverTs": { "type": [ "number", "null" ] }, "rid": { "type": [ "string", "null" ] }, "entries": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "m": { "type": [ "string", "null" ] }, "c": { "type": [ "string", "null" ] }, "n": { "type": [ "string", "null" ] }, "t": { "type": [ "string", "null" ] }, "i": { "type": [ "string", "null" ] }, "mc": { "type": [ "number", "null" ] }, "v": { "type": [ "number", "null" ] }, "vUsd": { "type": [ "number", "null" ] }, "p": { "type": [ "number", "null" ] }, "v5": { "type": [ "number", "null" ] }, "v15": { "type": [ "number", "null" ] }, "v1h": { "type": [ "number", "null" ] }, "v24h": { "type": [ "number", "null" ] }, "vUsd5": { "type": [ "number", "null" ] }, "vUsd15": { "type": [ "number", "null" ] }, "vUsd1h": { "type": [ "number", "null" ] }, "vUsd24h": { "type": [ "number", "null" ] }, "tx5": { "type": [ "number", "null" ] }, "age": { "type": [ "number", "null" ] }, "kol": { "type": [ "number", "null" ] }, "sn": { "type": [ "number", "null" ] }, "mh": { "type": [ "boolean", "null" ] }, "hs": { "type": [ "boolean", "null" ] }, "pg": { "type": [ "string", "null" ] }, "pl": { "type": [ "string", "null" ] }, "lp": { "type": [ "string", "null" ] }, "gd": { "type": [ "number", "null" ] }, "ath": { "type": [ "number", "null" ] }, "bc": { "type": [ "number", "null" ] }, "sc": { "type": [ "number", "null" ] }, "txc": { "type": [ "number", "null" ] }, "nh": { "type": [ "number", "null" ] }, "t10": { "type": [ "number", "null" ] }, "dh": { "type": [ "number", "null" ] }, "tw": { "type": [ "boolean", "null" ] }, "ws": { "type": [ "boolean", "null" ] }, "tg": { "type": [ "boolean", "null" ] }, "cb": { "type": [ "boolean", "null" ] }, "hr": { "type": [ "boolean", "null" ] }, "dw": { "type": [ "string", "null" ] }, "lv": { "type": [ "boolean", "null" ] }, "np": { "type": [ "number", "null" ] }, "ic": { "type": [ "boolean", "null" ] }, "so": { "type": [ "number", "null" ] }, "bo": { "type": [ "number", "null" ] }, "pa": { "type": [ "string", "null" ] }, "desc": { "type": [ "string", "null" ] }, "ih": { "type": [ "boolean", "null" ] }, "tf": { "type": [ "number", "null" ] }, "tfUsd": { "type": [ "number", "null" ] }, "rid": { "type": [ "string", "null" ] } } } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "board": "movers", "version": 0, "serverTs": 1793068418049, "rid": "33791109-adeb-4672-9c53-87a7cec19bbd", "entries": [ { "m": "DMnMwUvo1a9HbSnixbdNaTsoHczJ8cdamUWVRM1Qpump", "c": "solana:mainnet", "n": "hachi", "t": "HACHI", "i": "https://pump.mypinata.cloud/ipfs/bafybeifcupdkhiptds45hm2t2ktbdj4xdaaryawisggb44ofecujhzimxu", "mc": 283429.9323915603, "v": 13931.290694258803, "vUsd": 1401115.8241099545, "p": 100, "v5": 356.7156161490001, "v15": 1355.4134753570002, "v1h": 8401.597013714, "v24h": 13931.290694258998, "vUsd5": 35779.9254060024, "vUsd15": 136039.7042574945, "vUsd1h": 844281.8976198111, "vUsd24h": 1401115.8241099608, "tx5": 887, "age": 6305, "kol": 20, "sn": 63, "mh": false, "hs": true, "pg": "pump", "pl": "", "lp": "pump", "gd": 1793062291000, "ath": 475074.69595382595, "bc": 17189, "sc": 13878, "txc": 31067, "nh": 2357, "t10": 18.3354, "dh": 0, "tw": true, "ws": true, "tg": false, "cb": false, "hr": true, "dw": "84kLjynrCipA4XCZs3qktYvtZQYFXbnLbadmQf8h5uEr", "lv": false, "np": 0, "ic": false, "so": 0.1515, "bo": 0.4684, "pa": "SOL", "ih": true, "tf": 97.5842960369994, "tfUsd": 9816.216145959257, "rid": "33791109-adeb-4672-9c53-87a7cec19bbd" }, { "m": "6C31wHskg626TbP4euQwSHg3wpUcP6VMsaNUWQeBpump", "c": "solana:mainnet", "n": "wiener", "t": "wiener", "i": "https://images.pump.fun/coin-image/6C31wHskg626TbP4euQwSHg3wpUcP6VMsaNUWQeBpump", "mc": 51838.738662494216, "v": 4557.264561371902, "vUsd": 458063.5044101163, "p": 100, "v5": 660.5549372323467, "v15": 714.1260410245187, "v1h": 4552.341516399764, "v24h": 4557.26456137191, "vUsd5": 66280.39694545521, "vUsd15": 71659.08477131002, "vUsd1h": 457568.93531221605, "vUsd24h": 458063.5044101174, "tx5": 498, "age": 3559, "kol": 20, "sn": 134, "mh": false, "hs": true, "pg": "pump", "pl": "", "lp": "pump", "gd": 1793064867000, "ath": 112318.6347836581, "bc": 4814, "sc": 4235, "txc": 9049, "nh": 386, "t10": 43.4099, "dh": 0, "tw": true, "ws": true, "tg": false, "cb": false, "hr": true, "dw": "8s927nFr7zjUGWk9Eok2pTckSAP2QLQUL5dzAeDhSJ98", "lv": false, "np": 0, "ic": false, "so": 4.2214, "bo": 0, "pa": "SPCX", "desc": "wiener", "ih": true, "tf": 50.34779659899962, "tfUsd": 5059.651794530269, "rid": "33791109-adeb-4672-9c53-87a7cec19bbd" } ] }, "meta": { "observedAt": 1793068418034, "ageMs": 30, "source": "fresh", "parts": { "trending": { "observedAt": 1793068418034, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coins/feed](https://pump.x4o2.com/v1/coins/feed): pump.fun home feed: ranked coins with market cap, protocol, creator and recent activity (0.001 USD via x402) The ranked coin feed pump.fun's home page loads: each coin's mint, name, image, market cap, protocol (pump bonding curve or AMM), creator, creation time and activity figures. A broader, slower-moving list than the trending board. Use for market-wide scans. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-150", "minimum": 1, "maximum": 150, "default": 50 }, "description": "Number of entries, 1-150", "example": "50" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "coins": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "coinMint": { "type": [ "string", "null" ] }, "coinName": { "type": [ "string", "null" ] }, "coinImage": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "coinDescription": {}, "marketCap": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "platform": {}, "program": { "type": [ "string", "null" ] }, "chain": { "type": [ "string", "null" ] }, "narrative": {}, "position": { "type": [ "object", "null" ], "properties": { "userId": { "type": [ "string", "null" ] }, "userName": { "type": [ "string", "null" ] }, "profileImage": { "type": [ "string", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "isVerified": { "type": [ "boolean", "null" ] }, "verifiedBadgeVisible": { "type": [ "boolean", "null" ] }, "resolvedAvatarDecoration": { "type": [ "string", "null" ] }, "xUsername": { "type": [ "string", "null" ] }, "xProfileImage": {}, "accountKind": { "type": [ "string", "null" ] }, "followerCount": { "type": [ "number", "null" ] }, "totalCallouts": { "type": [ "number", "null" ] }, "amountHeld": { "type": [ "number", "null" ] }, "valueUsd": { "type": [ "number", "null" ] }, "pnlUsd": { "type": [ "number", "null" ] }, "pnlPercentage": { "type": [ "number", "null" ] }, "realizedPnlUsd": { "type": [ "number", "null" ] }, "tokenPriceUsd": { "type": [ "number", "null" ] }, "costBasisAmount": { "type": [ "number", "null" ] }, "costBasisUsd": { "type": [ "number", "null" ] }, "amountBoughtUsd": { "type": [ "number", "null" ] }, "amountBought": { "type": [ "number", "null" ] }, "callout": { "type": [ "object", "null" ], "properties": { "calloutId": { "type": [ "string", "null" ] }, "chain": {}, "assetClass": { "type": [ "string", "null" ] }, "perp": {}, "calledOutAtMcap": { "type": [ "number", "null" ] }, "multiple": { "type": [ "number", "null" ] }, "thesis": { "type": [ "string", "null" ] }, "mediaUrl": {}, "calloutTimestamp": { "type": [ "string", "null" ] }, "likes": { "type": [ "number", "null" ] }, "hasLiked": {}, "updates": { "type": [ "array", "null" ] }, "updateCount": { "type": [ "number", "null" ] }, "commentCount": { "type": [ "number", "null" ] }, "replyCount": { "type": [ "number", "null" ] }, "maxMultiplier": { "type": [ "number", "null" ] }, "maxMultiplierAt": { "type": [ "string", "null" ] }, "calloutPrice": { "type": [ "number", "null" ] }, "repostCount": { "type": [ "number", "null" ] }, "quoteCount": { "type": [ "number", "null" ] }, "hasReposted": {}, "viewCount": { "type": [ "number", "null" ] }, "quotedCalloutId": {}, "quotedCallout": {}, "actingUserId": {}, "actingUser": {} } }, "contentKind": { "type": [ "string", "null" ] }, "quote": {} } }, "recommendationId": { "type": [ "string", "null" ] }, "recommendationRank": { "type": [ "number", "null" ] }, "followedHolders": {} } } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "coins": [ { "coinMint": "GgQkMxSG6zEnJDEWuRP8qXeemuBHupo1WMfSL8KWpump", "coinName": "OFFICIAL MUSK 2028", "coinImage": "https://ipfs.io/ipfs/QmVa7YUgZQEzfW4zjQdAatdTwEA9qAGzUxJVvTbrmu25TC", "symbol": "MUSK2028", "coinDescription": null, "marketCap": 41990.79492187116, "protocol": "pump", "platform": null, "program": "pump", "chain": "solana", "narrative": null, "position": { "userId": "117295aa-dd30-43fe-a8e0-780e987edf96", "userName": "clive_99", "profileImage": "https://socialimages.pump.fun/profile-images/117295aa-dd30-43fe-a8e0-780e987edf96/c714349c-0871-4026-a27a-3c4fc086e07f", "walletAddress": "EwDxFbpLu8aUQ1fAvB9mCfyNfj565pdoVpZRmK843hzn", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": "achievement:multiple-100x", "xUsername": "Clive_99", "xProfileImage": null, "accountKind": "person", "followerCount": 24542, "totalCallouts": 48, "amountHeld": 2733588.286763, "valueUsd": 110.8235526171346, "pnlUsd": 87.94099041030259, "pnlPercentage": 125.21465486527994, "realizedPnlUsd": 27.42753943975549, "tokenPriceUsd": 0.00004054142064984013, "costBasisAmount": 2733588.286763, "costBasisUsd": 50.3101016465875, "amountBoughtUsd": 70.23218688333202, "amountBought": 3973327.184992, "callout": { "calloutId": "4478f34e-991f-44c1-a753-d68b020e25d9", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 22135, "multiple": 1.929299836659658, "thesis": "Lmfao this guy bought the musk official 2028 website domain for $2k", "mediaUrl": null, "calloutTimestamp": "2026-10-27T02:30:02.935Z", "likes": 4, "hasLiked": null, "updates": [ { "id": "16308f02-9faf-43fb-b317-5475555ba677", "content": "Lmao ca on site and it looks good", "createdAt": "2026-10-27T02:32:03.102Z", "likeCount": 1, "mediaUrl": null, "parentMessageId": null, "repostCount": 0, "viewCount": 297 } ], "updateCount": 1, "commentCount": 0, "replyCount": 1, "maxMultiplier": 2.200288870518691, "maxMultiplierAt": "2026-10-27T02:32:09.678Z", "calloutPrice": 0.000022135026845, "repostCount": 1, "quoteCount": 0, "hasReposted": null, "viewCount": 1723, "quotedCalloutId": null, "quotedCallout": null, "actingUserId": null, "actingUser": null }, "contentKind": "callout", "quote": null }, "recommendationId": "1a19037c-c6da-4934-b6a2-a853f7365639", "recommendationRank": 1, "followedHolders": null }, { "coinMint": "DMnMwUvo1a9HbSnixbdNaTsoHczJ8cdamUWVRM1Qpump", "coinName": "hachi", "coinImage": "https://pump.mypinata.cloud/ipfs/bafybeifcupdkhiptds45hm2t2ktbdj4xdaaryawisggb44ofecujhzimxu", "symbol": "HACHI", "coinDescription": null, "marketCap": 287949.3675772208, "protocol": "pump", "platform": null, "program": "pump", "chain": "solana", "narrative": null, "position": { "userId": "f38c405e-524f-4e9d-bf4b-41bb8f1f80ae", "userName": "cap", "profileImage": "https://socialimages.pump.fun/profile-images/f38c405e-524f-4e9d-bf4b-41bb8f1f80ae/73ff9f18-e9a0-4349-a9e3-9f8ea6c14a86", "walletAddress": "CAPn1yH4oSywsxGU456jfgTrSSUidf9jgeAnHceNUJdw", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": "legendary", "xUsername": "cap100x", "xProfileImage": null, "accountKind": "person", "followerCount": 117509, "totalCallouts": 281, "amountHeld": 22581685.141896997, "valueUsd": 6626.84969508924, "pnlUsd": 6822.251891975305, "pnlPercentage": 252.63946854880922, "realizedPnlUsd": 2895.7925718196093, "tokenPriceUsd": 0.0002934612564761208, "costBasisAmount": 22581685.141896997, "costBasisUsd": 2700.390374933545, "amountBoughtUsd": 2104.84526340122, "amountBought": 60101933.311647, "callout": { "calloutId": "1027459b-c1d3-4c12-a27e-bec94a3bf6e2", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 22913, "multiple": 11.43070192893623, "thesis": "We are all Hachi, waiting for our airdrop. Those who are smart, know.", "mediaUrl": null, "calloutTimestamp": "2026-10-27T00:56:38.968Z", "likes": 39, "hasLiked": null, "updates": [ { "id": "bfc05376-6ac6-470a-b4d2-a73c0004ebd4", "content": "dev just setup a website to make your own PFP\r\n\r\nEVERYONE CHANGE EM, WE ARE HACHI.\r\n\r\nhttps://x.com/HachiOnPf/status/...", "createdAt": "2026-10-27T02:22:47.760Z", "likeCount": 11, "mediaUrl": "https://socialimages.pump.fun/community-media/f38c405e-524f-4e9d-bf4b-41bb8f1f80ae/3dbef04d-faaa-4faa-81d1-2089dd60fee9", "parentMessageId": null, "repostCount": 3, "viewCount": 783 }, { "id": "6783b482-efff-4794-9e19-69267843e12b", "content": "Loving this content, dev knows game", "createdAt": "2026-10-27T01:55:28.916Z", "likeCount": 23, "mediaUrl": "https://socialimages.pump.fun/community-media/f38c405e-524f-4e9d-bf4b-41bb8f1f80ae/f04e0d3b-28da-47fb-8779-77e95a3cbd2b", "parentMessageId": null, "repostCount": 6, "viewCount": 2062 } ], "updateCount": 10, "commentCount": 17, "replyCount": 27, "maxMultiplier": 19.928031648372535, "maxMultiplierAt": "2026-10-27T02:17:19.643Z", "calloutPrice": 0.0000238414959363, "repostCount": 8, "quoteCount": 0, "hasReposted": null, "viewCount": 11479, "quotedCalloutId": null, "quotedCallout": null, "actingUserId": null, "actingUser": null }, "contentKind": "callout", "quote": null }, "recommendationId": "1a19037c-c6da-4934-b6a2-a853f7365639", "recommendationRank": 2, "followedHolders": null } ] }, "meta": { "observedAt": 1793068418067, "ageMs": 219, "source": "fresh", "parts": { "homeFeed": { "observedAt": 1793068418067, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coins/live](https://pump.x4o2.com/v1/coins/live): Coins currently livestreaming on pump.fun, with viewer counts and market data (0.001 USD via x402) Coins whose creators are live on pump.fun right now: coin metadata, market cap, bonding-curve state, livestream participant counts and thumbnail. Use to track the livestream meta. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-100", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Number of entries, 1-100", "example": "20" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination offset", "minimum": 0, "maximum": 100000 }, "description": "Pagination offset", "example": "0" }, { "name": "nsfw", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 includes coins flagged NSFW", "enum": [ 0, 1 ] }, "description": "1 includes coins flagged NSFW", "example": "0" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "initialized": { "type": [ "boolean", "null" ] }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "image_uri": { "type": [ "string", "null" ] }, "metadata_uri": { "type": [ "string", "null" ] }, "twitter": { "type": [ "string", "null" ] }, "bonding_curve": { "type": [ "string", "null" ] }, "associated_bonding_curve": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "created_timestamp": { "type": [ "number", "null" ] }, "complete": { "type": [ "boolean", "null" ] }, "hidden": { "type": [ "boolean", "null" ] }, "total_supply": { "type": [ "number", "null" ] }, "show_name": { "type": [ "boolean", "null" ] }, "last_trade_timestamp": { "type": [ "number", "null" ] }, "market_cap": { "type": [ "number", "null" ] }, "nsfw": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "pump_swap_pool": { "type": [ "string", "null" ] }, "livestream_ban_expiry": { "type": [ "number", "null" ] }, "is_currently_live": { "type": [ "boolean", "null" ] }, "ath_market_cap": { "type": [ "number", "null" ] }, "ath_market_cap_timestamp": { "type": [ "number", "null" ] }, "hide_banner": { "type": [ "boolean", "null" ] }, "program": { "type": [ "string", "null" ] }, "token_program": { "type": [ "string", "null" ] }, "quote_mint": { "type": [ "string", "null" ] }, "base_decimals": { "type": [ "number", "null" ] }, "quote_decimals": { "type": [ "number", "null" ] }, "pool_address": { "type": [ "string", "null" ] }, "is_cashback_enabled": { "type": [ "boolean", "null" ] }, "indexed_by_pump": { "type": [ "boolean", "null" ] }, "tokenized_agent": { "type": [ "boolean", "null" ] }, "chain_id": { "type": [ "string", "null" ] }, "multichain_family": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "is_charity": { "type": [ "boolean", "null" ] }, "total_supply_str": { "type": [ "string", "null" ] }, "market_cap_usd": { "type": [ "number", "null" ] }, "market_cap_quote": { "type": [ "number", "null" ] }, "canonical_pool_liquidity_usd": { "type": [ "number", "null" ] }, "boost_mode": { "type": [ "string", "null" ] }, "verified": { "type": [ "boolean", "null" ] }, "is_holder_reward": { "type": [ "boolean", "null" ] }, "transfer_fee_bps": { "type": [ "number", "null" ] }, "is_backfill": { "type": [ "boolean", "null" ] }, "transfer_hook_program": { "type": [ "string", "null" ] }, "depth": { "type": [ "number", "null" ] }, "security_verdict": { "type": [ "object", "null" ], "properties": { "verdict": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "reasons": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "decided_by": { "type": [ "string", "null" ] }, "provider": { "type": [ "string", "null" ] }, "version": { "type": [ "number", "null" ] }, "updated_at": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] } } }, "usd_market_cap": { "type": [ "number", "null" ] }, "thumbnail": { "type": [ "string", "null" ] }, "thumbnail_updated_at": { "type": [ "number", "null" ] }, "num_participants": { "type": [ "number", "null" ] }, "livestream_title": { "type": [ "string", "null" ] }, "playlist_url": { "type": [ "string", "null" ] }, "playlist_url_high": { "type": [ "string", "null" ] }, "playlist_url_low": { "type": [ "string", "null" ] }, "vod_playlist_url": { "type": [ "string", "null" ] }, "playlist_status": { "type": [ "string", "null" ] } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": [ { "mint": "21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump", "initialized": true, "name": "The Nut Reaper", "symbol": "NUTR", "description": "Halloween is here, and the Reaper has arrived… but this time, he’s coming for your nuts. 🥜💀 As October fades into d...", "image_uri": "https://ipfs.io/ipfs/bafkreigucczh3fwmlbodcicjjbbkkwsernm6iwwlp25vy5z5x4tvb53mxi", "metadata_uri": "https://ipfs.io/ipfs/QmNoBYs5SsLTMdfZsLZxsZ91AbekcTMHaMsZPSBCSscniU", "twitter": "https://x.com/probalybroke?s=11", "bonding_curve": "7ogQEmazkm5F81sfwomNs3TJjkHdMbRoMVMCGQ8QF5yw", "associated_bonding_curve": "9MyiLAuhcTeqXUsnE2v65JMiDSgcTXxSfQormpCox5KF", "creator": "DhMZssJugmEqw6JDzH3NUhs1zBvJvPisy7vfTPDQVViz", "created_timestamp": 1792999088000, "complete": false, "hidden": false, "total_supply": 1000000000000000, "show_name": true, "last_trade_timestamp": 1793068365000, "market_cap": 46.40144092342358, "nsfw": false, "is_banned": false, "livestream_ban_expiry": 0, "is_currently_live": true, "ath_market_cap": 5268.141844673489, "ath_market_cap_timestamp": 1793054026000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "D7uCeqo9BcGspQpKjwDvMqffWj7dJmD8VtcYZHveUuvj", "is_cashback_enabled": false, "indexed_by_pump": false, "tokenized_agent": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "pump", "is_charity": false, "total_supply_str": "1000000000000000", "market_cap_usd": 4656.384596665555, "market_cap_quote": 46.40144092342358, "canonical_pool_liquidity_usd": 867.8196368163, "boost_mode": "NONE", "verified": false, "is_holder_reward": false, "transfer_fee_bps": 0, "is_backfill": false, "transfer_hook_program": "", "depth": 0, "security_verdict": { "verdict": "allow", "scope": "all", "reasons": [ "benign" ], "decided_by": "default", "provider": "none", "version": 10, "updated_at": 1793068291129, "source": "" }, "usd_market_cap": 4656.384596665555, "thumbnail": "https://clips.pump.fun/21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump/2610655_20261027_021101/thumb.jpg", "thumbnail_updated_at": 1793067120027, "num_participants": 6, "livestream_title": "DEV LIVE", "playlist_url": "https://clips.pump.fun/21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump/2610655_20261027_021101/playlist_20261027_021101_...", "playlist_url_high": "https://clips.pump.fun/21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump/2610655_20261027_021101/playlist_20261027_021101_...", "playlist_url_low": "https://clips.pump.fun/21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump/2610655_20261027_021101/playlist_20261027_021101_...", "vod_playlist_url": "https://clips.pump.fun/21KUG4K8t2D7GoRhRjzYntfgwq1S3dhFhuF6RUSypump/2610655_20261027_021101/master_playlist_20261027_...", "playlist_status": "ACTIVE", "playlist_updated_at": "2026-10-27T02:33:31.873Z" }, { "mint": "DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump", "initialized": true, "name": "Wifoween", "symbol": "Wifoween", "description": "Last year I was live for months and ran Wifmas to 5 million market cap The trenches have been dead lately and its th...", "image_uri": "https://ipfs.io/ipfs/bafybeiek3onzi7mrxscshclonzyhtq3rvciv6mbzmagjywkb3mwmq6kgl4", "metadata_uri": "https://ipfs.io/ipfs/bafkreid4hj76v73lqocu2qbpat5hx2x4bnbwthwbczqt65lduqj3rxvkcm", "twitter": "https://x.com/wifoweenonpump/status/2114838771736985696", "bonding_curve": "BoFkUrggEbc4yZgxqiB8nrcfaMUweBud8nqazgTPvjVe", "associated_bonding_curve": "58o21HUMk8vgMp8Nv564A42Aw31TusbxpGRiCarUAeNB", "creator": "FH15gfwbKYA16194BhjaodzpD47eWQsuzJZS9xwYnfRp", "created_timestamp": 1793051947000, "complete": true, "hidden": false, "total_supply": 1000000000000000, "show_name": true, "last_trade_timestamp": 1793068403000, "market_cap": 606.6775564648564, "nsfw": false, "is_banned": false, "pump_swap_pool": "7uQqLaNyahzkmt6ydMZgLAbmfy7SFik3mg13HP9x8hiH", "livestream_ban_expiry": 0, "is_currently_live": true, "ath_market_cap": 167384.4505703179, "ath_market_cap_timestamp": 1793053502000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "7uQqLaNyahzkmt6ydMZgLAbmfy7SFik3mg13HP9x8hiH", "is_cashback_enabled": false, "indexed_by_pump": false, "tokenized_agent": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "pump", "is_charity": false, "total_supply_str": "1000000000000000", "market_cap_usd": 60866.891001064265, "market_cap_quote": 606.6775564648564, "canonical_pool_liquidity_usd": 21992.153081508503, "boost_mode": "COMPLETED", "verified": false, "is_holder_reward": false, "transfer_fee_bps": 0, "is_backfill": false, "transfer_hook_program": "", "depth": 0, "security_verdict": { "verdict": "allow", "scope": "all", "reasons": [ "benign" ], "decided_by": "default", "provider": "none", "version": 13, "updated_at": 1793067180203, "source": "" }, "usd_market_cap": 60866.891001064265, "thumbnail": "https://clips.pump.fun/DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump/2610589_20261027_010140/thumb.jpg", "thumbnail_updated_at": 1793062950078, "num_participants": 54, "livestream_title": "wifoween", "playlist_url": "https://clips.pump.fun/DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump/2610589_20261027_010140/playlist_20261027_010140_...", "playlist_url_high": "https://clips.pump.fun/DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump/2610589_20261027_010140/playlist_20261027_010140_...", "playlist_url_low": "https://clips.pump.fun/DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump/2610589_20261027_010140/playlist_20261027_010140_...", "vod_playlist_url": "https://clips.pump.fun/DtBatQsrazRRVp37UTMQH7TnXL1mT2qrJTj7PB9Rpump/2610589_20261027_010140/master_playlist_20261027_...", "playlist_status": "ACTIVE", "playlist_updated_at": "2026-10-27T02:33:31.348Z" } ], "meta": { "observedAt": 1793068418288, "ageMs": 27, "source": "fresh", "parts": { "live": { "observedAt": 1793068418288, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coins/search](https://pump.x4o2.com/v1/coins/search): Search pump.fun coins by name, ticker or mint (0.001 USD via x402) pump.fun's coin search: matches on name, symbol, description or mint, ranked by USD market cap. Returns full coin records (mint, metadata, market cap, creator, bonding-curve state). Use to resolve a ticker or name to a mint. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Search text (name, ticker, mint or description), up to 100 characters" }, "description": "Search text (name, ticker, mint or description), up to 100 characters", "example": "cat" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-100", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Number of entries, 1-100", "example": "20" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination offset", "minimum": 0, "maximum": 100000 }, "description": "Pagination offset", "example": "0" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "initialized": { "type": [ "boolean", "null" ] }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "image_uri": { "type": [ "string", "null" ] }, "metadata_uri": { "type": [ "string", "null" ] }, "bonding_curve": { "type": [ "string", "null" ] }, "associated_bonding_curve": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "created_timestamp": { "type": [ "number", "null" ] }, "complete": { "type": [ "boolean", "null" ] }, "hidden": { "type": [ "boolean", "null" ] }, "total_supply": { "type": [ "number", "null" ] }, "show_name": { "type": [ "boolean", "null" ] }, "last_trade_timestamp": { "type": [ "number", "null" ] }, "nsfw": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "livestream_ban_expiry": { "type": [ "number", "null" ] }, "is_currently_live": { "type": [ "boolean", "null" ] }, "ath_market_cap": { "type": [ "number", "null" ] }, "ath_market_cap_timestamp": { "type": [ "number", "null" ] }, "hide_banner": { "type": [ "boolean", "null" ] }, "program": { "type": [ "string", "null" ] }, "platform": { "type": [ "string", "null" ] }, "token_program": { "type": [ "string", "null" ] }, "quote_mint": { "type": [ "string", "null" ] }, "base_decimals": { "type": [ "number", "null" ] }, "quote_decimals": { "type": [ "number", "null" ] }, "pool_address": { "type": [ "string", "null" ] }, "is_cashback_enabled": { "type": [ "boolean", "null" ] }, "indexed_by_pump": { "type": [ "boolean", "null" ] }, "tokenized_agent": { "type": [ "boolean", "null" ] }, "chain_id": { "type": [ "string", "null" ] }, "multichain_family": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "is_charity": { "type": [ "boolean", "null" ] }, "total_supply_str": { "type": [ "string", "null" ] }, "market_cap_usd": { "type": [ "number", "null" ] }, "market_cap_quote": { "type": [ "number", "null" ] }, "boost_mode": { "type": [ "string", "null" ] }, "verified": { "type": [ "boolean", "null" ] }, "is_holder_reward": { "type": [ "boolean", "null" ] }, "transfer_fee_bps": { "type": [ "number", "null" ] }, "is_backfill": { "type": [ "boolean", "null" ] }, "transfer_hook_program": { "type": [ "string", "null" ] }, "depth": { "type": [ "number", "null" ] }, "security_verdict": { "type": [ "object", "null" ], "properties": { "verdict": { "type": [ "string", "null" ] }, "scope": { "type": [ "string", "null" ] }, "reasons": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "decided_by": { "type": [ "string", "null" ] }, "provider": { "type": [ "string", "null" ] }, "version": { "type": [ "number", "null" ] }, "updated_at": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] } } }, "usd_market_cap": { "type": [ "number", "null" ] }, "market_cap": { "type": [ "number", "null" ] }, "volume_1h_usd": { "type": [ "number", "null" ] }, "circulating_supply_str": { "type": [ "string", "null" ] }, "source": { "type": [ "string", "null" ] }, "price_usd": { "type": [ "number", "null" ] }, "recommendation_id": { "type": [ "string", "null" ] }, "recommendation_rank": { "type": [ "number", "null" ] }, "search_priority": { "type": [ "boolean", "null" ] }, "preview": { "type": [ "boolean", "null" ] }, "twitter": { "type": [ "string", "null" ] }, "telegram": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "canonical_pool_liquidity_usd": { "type": [ "number", "null" ] } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": [ { "mint": "0x020bfC650A365f8BB26819deAAbF3E21291018b4", "initialized": false, "name": "Cash Cat", "symbol": "CASHCAT", "image_uri": "https://coin-images.coingecko.com/coins/images/102174280/large/cashcat-logo.jpg?1782922765", "twitter": "https://x.com/cashcat_token", "telegram": "https://t.me/cashcat_robinhood", "creator": "0xcdfc08a1c1fbafb355645e5ddc32122e5716ca90", "created_timestamp": 1781812885000, "complete": false, "hidden": false, "website": "https://cashcat.cc/", "show_name": true, "last_trade_timestamp": 1793068399000, "market_cap": 90811022.31692357, "nsfw": false, "is_banned": false, "livestream_ban_expiry": 0, "is_currently_live": false, "ath_market_cap": 988480913727.4153, "ath_market_cap_timestamp": 1790197333000, "hide_banner": false, "quote_mint": "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73", "base_decimals": 18, "quote_decimals": 18, "pool_address": "0xa92a3df27a00a276183ff7265fd8affa11df1fe8bb23ddfaf13f6c879a3f818b", "is_cashback_enabled": false, "indexed_by_pump": false, "tokenized_agent": false, "chain_id": "eip155:4663", "multichain_family": 2, "protocol": "pons", "is_charity": false, "circulating_supply_str": "987742614992649738461904896", "total_supply_str": "1000000000000000000000000000", "market_cap_usd": 90811022.31692357, "market_cap_quote": 90811022.31692357, "canonical_pool_liquidity_usd": 1312282.824792, "boost_mode": "NONE", "verified": true, "is_holder_reward": false, "is_backfill": false, "security_verdict": { "verdict": "allow", "scope": "all", "reasons": [ "operator_bypass", "trusted_launchpad" ], "decided_by": "bypass", "provider": "none", "version": 40, "updated_at": 1792625689298, "source": "" }, "usd_market_cap": 90811022.31692357, "volume_1h_usd": 47681.20706502009, "source": "indexed", "price_usd": 0.0919379410572453, "recommendation_id": "search:21a7ac01-108b-47ec-9e2e-bee38782123a", "recommendation_rank": 1, "search_priority": true, "preview": true }, { "mint": "HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR", "initialized": true, "name": "Anonymous Cat", "symbol": "ZCAT", "description": "Anonymous Cat was launched on StonkFun.", "image_uri": "https://gateway.irys.xyz/7uFsXwyuyzKDiqdda4L2cq3DcpcdRqYhwe4m8ZoVJ1BQ", "metadata_uri": "https://gateway.irys.xyz/GNy6d9dhhEuxFBqKb8Egm5beiRML4fDUS6zuKQuTs7Ys", "bonding_curve": "BTccxxTFi7a9xJTE1exKn38Jgie35s6gNeRxd8DM61Rc", "associated_bonding_curve": "8zLyZyiyXPQmB9UU7cTs7bwiqMHL445AoaB1z7P1GwQE", "creator": "5CEbueQnq1Ym2uSSx2xXds3jQAqT1BDnkA59RZobSPAG", "created_timestamp": 1788132595000, "complete": false, "hidden": false, "total_supply": 1000000000000000000, "show_name": true, "last_trade_timestamp": 1793067559000, "nsfw": false, "is_banned": false, "livestream_ban_expiry": 0, "is_currently_live": false, "ath_market_cap": 183439810.78343496, "ath_market_cap_timestamp": 1788742683000, "hide_banner": false, "program": "stonkfun", "platform": "stonkfun", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS", "base_decimals": 9, "quote_decimals": 8, "pool_address": "BTccxxTFi7a9xJTE1exKn38Jgie35s6gNeRxd8DM61Rc", "is_cashback_enabled": false, "indexed_by_pump": false, "tokenized_agent": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "stonkfun", "is_charity": false, "total_supply_str": "1000000000000000000", "market_cap_usd": 48191748.43911845, "market_cap_quote": 39353.37029576242, "boost_mode": "NONE", "verified": true, "is_holder_reward": false, "transfer_fee_bps": 300, "is_backfill": false, "transfer_hook_program": "", "depth": 0, "security_verdict": { "verdict": "allow", "scope": "all", "reasons": [ "operator_bypass" ], "decided_by": "bypass", "provider": "none", "version": 39, "updated_at": 1793004580697, "source": "" }, "usd_market_cap": 48191748.43911845, "market_cap": 480293.0630570943, "volume_1h_usd": 739.9345904481783, "circulating_supply_str": "1000000000000000000", "source": "indexed", "price_usd": 0.04819174843911845, "recommendation_id": "search:21a7ac01-108b-47ec-9e2e-bee38782123a", "recommendation_rank": 2, "search_priority": true, "preview": true } ], "meta": { "observedAt": 1793068418317, "ageMs": 177, "source": "fresh", "parts": { "search": { "observedAt": 1793068418317, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/coins](https://pump.x4o2.com/v1/coins): List pump.fun coins sorted by market cap, creation time, last trade or reply count (0.001 USD via x402) pump.fun's paginated coin list: full coin records sorted by market_cap, created_timestamp, last_trade_timestamp, reply_count or last_reply. Use sort=created_timestamp for new launches, market_cap for the biggest. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort key; created_timestamp lists new launches", "enum": [ "market_cap", "created_timestamp", "last_trade_timestamp", "reply_count", "last_reply" ] }, "description": "Sort key; created_timestamp lists new launches", "example": "market_cap" }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort order", "enum": [ "ASC", "DESC" ] }, "description": "Sort order", "example": "DESC" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-100", "minimum": 1, "maximum": 100, "default": 50 }, "description": "Number of entries, 1-100", "example": "50" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination offset", "minimum": 0, "maximum": 100000 }, "description": "Pagination offset", "example": "0" }, { "name": "nsfw", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 includes coins flagged NSFW", "enum": [ 0, 1 ] }, "description": "1 includes coins flagged NSFW", "example": "0" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "initialized": { "type": [ "boolean", "null" ] }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "image_uri": { "type": [ "string", "null" ] }, "metadata_uri": { "type": [ "string", "null" ] }, "twitter": { "type": [ "string", "null" ] }, "bonding_curve": { "type": [ "string", "null" ] }, "associated_bonding_curve": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "created_timestamp": { "type": [ "number", "null" ] }, "complete": { "type": [ "boolean", "null" ] }, "virtual_sol_reserves": { "type": [ "number", "null" ] }, "virtual_token_reserves": { "type": [ "number", "null" ] }, "total_supply": { "type": [ "number", "null" ] }, "website": { "type": [ "string", "null" ] }, "show_name": { "type": [ "boolean", "null" ] }, "last_trade_timestamp": { "type": [ "number", "null" ] }, "market_cap": { "type": [ "number", "null" ] }, "nsfw": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "real_sol_reserves": { "type": [ "number", "null" ] }, "real_token_reserves": { "type": [ "number", "null" ] }, "updated_at": { "type": [ "number", "null" ] }, "livestream_ban_expiry": { "type": [ "number", "null" ] }, "reply_count": { "type": [ "number", "null" ] }, "is_currently_live": { "type": [ "boolean", "null" ] }, "ath_market_cap": { "type": [ "number", "null" ] }, "ath_market_cap_timestamp": { "type": [ "number", "null" ] }, "hide_banner": { "type": [ "boolean", "null" ] }, "program": { "type": [ "string", "null" ] }, "token_program": { "type": [ "string", "null" ] }, "mayhem_state": { "type": [ "string", "null" ] }, "quote_mint": { "type": [ "string", "null" ] }, "base_decimals": { "type": [ "number", "null" ] }, "quote_decimals": { "type": [ "number", "null" ] }, "pool_address": { "type": [ "string", "null" ] }, "is_cashback_enabled": { "type": [ "boolean", "null" ] }, "chain_id": { "type": [ "string", "null" ] }, "multichain_family": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "total_supply_str": { "type": [ "string", "null" ] }, "market_cap_usd": { "type": [ "number", "null" ] }, "virtual_quote_reserves": { "type": [ "number", "null" ] }, "real_quote_reserves": { "type": [ "number", "null" ] }, "market_cap_quote": { "type": [ "number", "null" ] }, "boost_mode": { "type": [ "string", "null" ] }, "verified": { "type": [ "boolean", "null" ] }, "quote_token_program": { "type": [ "string", "null" ] }, "is_holder_reward": { "type": [ "boolean", "null" ] }, "transfer_fee_bps": { "type": [ "number", "null" ] }, "transfer_hook_program": { "type": [ "string", "null" ] }, "depth": { "type": [ "number", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image": { "type": [ "string", "null" ] }, "usd_market_cap": { "type": [ "number", "null" ] } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": [ { "mint": "9piDKoH2b8jyFc2jhRmhWLiki7FDr4Se2AMD6iXKpump", "initialized": true, "name": "Cornell", "symbol": "Cornell", "image_uri": "https://ipfs.io/ipfs/bafkreia5xlhi4codgm2a6fo3dlbbh4lpgmjzlugvs3lurdi2qrattox4y4", "metadata_uri": "https://ipfs.io/ipfs/QmRGywfyv1KVNA77xoEYpz3Wp1njZWjpjR5U6X5jvwMt6b", "bonding_curve": "2rMZBjZ6P8AUjgBn5KsnkikdMqbejTbmjr7TG9MxYyTY", "associated_bonding_curve": "3HX4K1aXNUpnpBGx58bq6n9SAQ9fEnYEquMjsM7k9Z7Q", "creator": "CuDe51GPh5qGsmYBJDxSsufhQQhA618uDbkaXFZ4pztL", "created_timestamp": 1793068417000, "complete": false, "virtual_sol_reserves": 33045658580, "virtual_token_reserves": 893750224209883, "total_supply": 1000000000000000, "show_name": true, "last_trade_timestamp": 1793068417000, "market_cap": 36.97415417066206, "nsfw": false, "is_banned": false, "real_sol_reserves": 6016774183, "real_token_reserves": 613850224209883, "updated_at": 1793068418, "livestream_ban_expiry": 0, "reply_count": 0, "is_currently_live": false, "ath_market_cap": 4227.631116940714, "ath_market_cap_timestamp": 1793068416000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "mayhem_state": "enabled", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "D8mbUWMspMJGt8PxvVwRytM3CMQprRmtc6E47bCiqr14", "is_cashback_enabled": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "pump", "total_supply_str": "1000000000000000", "market_cap_usd": 3709.736654548766, "virtual_quote_reserves": 33045658580, "real_quote_reserves": 6016774183, "market_cap_quote": 36.97415417066206, "boost_mode": "NONE", "verified": false, "quote_token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", "is_holder_reward": false, "transfer_fee_bps": 0, "transfer_hook_program": "", "depth": 0, "username": "Henrys0x", "profile_image": "https://socialimages.pump.fun/profile-images/82ba7461-0d34-446e-9230-15ab674b0675/16698dcb-7408-4c19-91f2-9143a059a6a8", "usd_market_cap": 3709.736654548766 }, { "mint": "8arSwKjZCEmhD7FU1uDYVqHdu9gJ5F16V1mFFaKfpump", "initialized": true, "name": "Magic Eden", "symbol": "MAGICEDEN", "description": "Magic Eden is the leading Solana NFT Marketplace. Buy, sell, and discover NFTs from top creators. Enjoy bulk NFT list...", "image_uri": "https://ipfs.io/ipfs/bafkreidteadaff62ysg5ba4y6qizp4oe2dpfpnud7jbskno63jlzdx3t7a", "metadata_uri": "https://ipfs.io/ipfs/QmfZSPAUC6RGhUBm1nTxkFydH87FgS3NRz4nbaDUAiGECd", "twitter": "https://x.com/magiceden?s=11", "bonding_curve": "CzqMJtQX8jVrkx4kpZnP46MtgddkqTAtbpGp7WSL1Sm3", "associated_bonding_curve": "AzT5AY41x5JMEGWQrpzo3n3PqoaK31Tg1hxJzpFKtLZx", "creator": "473v2ovKSvQYYyhtQrFFYcq333oPZNcsdg26dpiysK5z", "created_timestamp": 1793068413000, "complete": false, "virtual_sol_reserves": 22509283296, "virtual_token_reserves": 1069281097270229, "total_supply": 1000000000000000, "website": "https://magiceden.io/", "show_name": true, "last_trade_timestamp": 1793068417000, "market_cap": 21.050856835928382, "nsfw": false, "is_banned": false, "real_sol_reserves": 86120368, "real_token_reserves": 789381097270229, "updated_at": 1793068418, "livestream_ban_expiry": 0, "reply_count": 0, "is_currently_live": false, "ath_market_cap": 3133.121126770072, "ath_market_cap_timestamp": 1793068413000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "mayhem_state": "active", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "EhHemMh7htoC3ZQ4hasP3tzvCBTvYLXfGa3bMJ9B2roJ", "is_cashback_enabled": false, "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "multichain_family": 1, "protocol": "pump", "total_supply_str": "1000000000000000", "market_cap_usd": 2112.1006542420555, "virtual_quote_reserves": 22509283296, "real_quote_reserves": 86120368, "market_cap_quote": 21.050856835928382, "boost_mode": "NONE", "verified": false, "quote_token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", "is_holder_reward": false, "transfer_fee_bps": 0, "transfer_hook_program": "", "depth": 0, "username": "kingphan", "profile_image": "https://socialimages.pump.fun/profile-images/622d1c08-c4fe-4ccf-a13d-324624f8f3ad/a7f3397b-5d0e-4de5-88e1-8b8eec5dfe6b", "usd_market_cap": 2112.1006542420555 } ], "meta": { "observedAt": 1793068418495, "ageMs": 37, "source": "fresh", "parts": { "coins": { "observedAt": 1793068418495, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/leaderboard](https://pump.x4o2.com/v1/leaderboard): pump.fun P&L leaderboard: top wallets by realized and unrealized profit over a period (0.001 USD via x402) pump.fun's trader leaderboard: rank, wallet, username, P&L in SOL and USD, percent return, buy spend, realized and unrealized split, for the daily, weekly or monthly period (pump.fun has no all-time board). The top 100 per period is all there is: no paging, no per-wallet rank lookup. Also returns the SOL price. include=evm adds each trader's EVM and Solana wallets from their profile in one extra call. Use to find the best-performing traders to follow. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Leaderboard period", "enum": [ "daily", "weekly", "monthly" ] }, "description": "Leaderboard period", "example": "daily" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Rank by", "enum": [ "combined", "realized", "unrealized", "percent" ] }, "description": "Rank by", "example": "combined" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of entries, 1-100", "minimum": 1, "maximum": 100, "default": 100 }, "description": "Number of entries, 1-100", "example": "100" }, { "name": "include", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated extras: evm (adds evmAddress and svmAddress to every entry from pump.fun's user profiles, one extra upstream call)" }, "description": "Comma-separated extras: evm (adds evmAddress and svmAddress to every entry from pump.fun's user profiles, one extra upstream call)", "example": "evm" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "leaderboard": { "type": [ "object", "null" ], "properties": { "entries": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "rank": { "type": [ "number", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "pnlSol": { "type": [ "number", "null" ] }, "pnlUsd": { "type": [ "number", "null" ] }, "pnlPercent": { "type": [ "number", "null" ] }, "buySpendSol": { "type": [ "number", "null" ] }, "lastRefreshedAtMs": { "type": [ "number", "null" ] }, "realizedPnlSol": { "type": [ "number", "null" ] }, "realizedPnlUsd": { "type": [ "number", "null" ] }, "unrealizedPnlSol": { "type": [ "number", "null" ] }, "unrealizedPnlUsd": { "type": [ "number", "null" ] }, "positionsCount": { "type": [ "number", "null" ] }, "topPositions": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ] } }, "username": { "type": [ "string", "null" ] }, "profileImage": { "type": [ "string", "null" ] }, "xUsername": { "type": [ "string", "null" ] }, "isVerified": { "type": [ "boolean", "null" ] }, "verifiedBadgeVisible": { "type": [ "boolean", "null" ] }, "userId": { "type": [ "string", "null" ] }, "resolvedAvatarDecoration": { "type": [ "string", "null" ] }, "evmAddress": { "type": [ "string", "null" ] }, "svmAddress": { "type": [ "string", "null" ] } } } }, "periodType": { "type": [ "number", "null" ] }, "periodLabel": { "type": [ "string", "null" ] }, "windowStartSec": { "type": [ "number", "null" ] } } }, "solPrice": { "type": [ "object", "null" ], "properties": { "solPrice": { "type": [ "number", "null" ] }, "asOfTimestamp": { "type": [ "number", "null" ] }, "stale": { "type": [ "boolean", "null" ] } } } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "leaderboard": { "entries": [ { "rank": 1, "walletAddress": "9BMzTpSo4URse1oN666pmexhdjpU1vA5p7LtroCFQdLU", "pnlSol": 1270.9641960483566, "pnlUsd": 127570.16656994581, "pnlPercent": 10.379484819639345, "buySpendSol": 4.039591310369118, "lastRefreshedAtMs": 1793068401966, "realizedPnlSol": 0, "realizedPnlUsd": 0, "unrealizedPnlSol": 1270.9641960483566, "unrealizedPnlUsd": 127570.16656994581, "positionsCount": 48, "topPositions": [ { "mint": "HuAXPyDWDaMYFKuwQHpqL1oPnj93zdzWmtvFGzCeCUa7", "chainId": 1399811149, "symbol": "MASK", "name": "Nullmask", "imageUri": "https://gateway.irys.xyz/7Dbdj8EPHEmf3bmRGnZMdeYTbDcKy7qGwrpDuqVzeKii" }, { "mint": "BCdwQBAn8dYB5YjTsoB6TdHAWokxv28k2oZUodERpump", "chainId": 1399811149, "symbol": "MANIFEST", "name": "Manifesting", "imageUri": "https://ipfs.io/ipfs/bafybeiemtmaqq2y7onn2lstwe53ofrlnvlhw5ika3uynqtqqzp3aqngy4a" } ], "username": "Aurelius", "profileImage": "https://socialimages.pump.fun/profile-images/33b4317c-3a2f-4027-be28-34fe8db86494/29feff3b-484e-4c04-b279-077efb6cabc9", "xUsername": "Aurelius0121", "isVerified": true, "verifiedBadgeVisible": false, "userId": "33b4317c-3a2f-4027-be28-34fe8db86494", "resolvedAvatarDecoration": "achievement:first-place", "evmAddress": "0x59037711e48a02c812f7dcf15bb7f9a1c51832b1", "svmAddress": "9BMzTpSo4URse1oN666pmexhdjpU1vA5p7LtroCFQdLU" }, { "rank": 2, "walletAddress": "EwJYY4q2rcrdEH26doRbYX9JxbpYPSNZvRLgzhPKi418", "pnlSol": 1061.6520043193477, "pnlUsd": 106536.77863344653, "pnlPercent": 15.134986344499387, "buySpendSol": 41.045815596447085, "lastRefreshedAtMs": 1793068256870, "realizedPnlSol": -0.13746077239286372, "realizedPnlUsd": -13.794188509623874, "unrealizedPnlSol": 1061.7894650917406, "unrealizedPnlUsd": 106550.57282195616, "positionsCount": 3, "topPositions": [ { "mint": "HuAXPyDWDaMYFKuwQHpqL1oPnj93zdzWmtvFGzCeCUa7", "chainId": 1399811149, "symbol": "MASK", "name": "Nullmask", "imageUri": "https://gateway.irys.xyz/7Dbdj8EPHEmf3bmRGnZMdeYTbDcKy7qGwrpDuqVzeKii" }, { "mint": "GM8EysYT8NRSsoULdeYShbRsUdhoUoiB9EN4eW3YETCH", "chainId": 1399811149, "symbol": "ETCHY", "name": "Etchy", "imageUri": "https://ipfs.io/ipfs/bafkreibzjuwqxdanqicwaha6toj6pwuncmcoeyhf4wksuueh2rsv4ivway" } ], "username": "heat", "profileImage": "https://socialimages.pump.fun/profile-images/df07bffb-d0fd-47db-b7a5-8ee87b463f28/6101a1b4-dc4a-4014-8759-8f164e646c67", "xUsername": "heat", "isVerified": true, "verifiedBadgeVisible": false, "userId": "df07bffb-d0fd-47db-b7a5-8ee87b463f28", "resolvedAvatarDecoration": "achievement:first-place", "evmAddress": "0x598508c237045821f2b915a56afee519b60bac41", "svmAddress": "EwJYY4q2rcrdEH26doRbYX9JxbpYPSNZvRLgzhPKi418" } ], "periodType": 3, "periodLabel": "24h", "windowStartSec": 1792980000 }, "solPrice": { "solPrice": 100.328239198, "asOfTimestamp": 1793068399379, "stale": false } }, "meta": { "observedAt": 1793068404109, "ageMs": 14487, "source": "fresh", "parts": { "leaderboard": { "observedAt": 1793068418533, "source": "fresh" }, "solPrice": { "observedAt": 1793068404109, "source": "cache" }, "usersBatch": { "observedAt": 1793068418565, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/users](https://pump.x4o2.com/v1/users): Up to 100 pump.fun user profiles by wallet in one call, with EVM and Solana wallets (0.001 USD via x402) The public profiles of up to 100 pump.fun users by wallet address in one upstream call: user id, username, bio, follower counts, X handle, badges, and each user's canonical Solana and EVM wallets (evmAddress is null when they have linked none). wallets not known to pump.fun are listed in notFound. The cheap way to get EVM addresses for many wallets at once, e.g. the wallets from /holders, /traders or /leaderboard. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "wallets", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated wallet addresses (base58), 1-100" }, "description": "Comma-separated wallet addresses (base58), 1-100", "example": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ,4Bc4Ue2G37zoQCiksAvwMgXQQJFKcYQThnoHPKizAmWB" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "users": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "address": { "type": [ "string", "null" ] }, "userId": { "type": [ "string", "null" ] }, "is_pump_user": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image": { "type": [ "string", "null" ] }, "avatar_decoration": {}, "resolved_avatar_decoration": { "type": [ "string", "null" ] }, "bio": { "type": [ "string", "null" ] }, "followers": { "type": [ "number", "null" ] }, "following": { "type": [ "number", "null" ] }, "x_username": { "type": [ "string", "null" ] }, "canonical_svm_wallet": { "type": [ "string", "null" ] }, "canonical_evm_wallet": { "type": [ "string", "null" ] }, "group_badges": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "group_id": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image_url": { "type": [ "string", "null" ] }, "role": { "type": [ "string", "null" ] } } } }, "active_competition_entry": {}, "evmAddress": { "type": [ "string", "null" ] }, "svmAddress": { "type": [ "string", "null" ] } } } }, "notFound": { "type": [ "array", "null" ] } } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "users": [ { "address": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "userId": "f779e161-0f93-49ec-b763-2142854fd005", "is_pump_user": true, "is_banned": false, "username": "SossaDotKek", "profile_image": "https://socialimages.pump.fun/profile-images/2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ/1483b61e-df0d-4b93-a3d4-161...", "avatar_decoration": null, "resolved_avatar_decoration": "epic", "bio": "Hodler by nature", "followers": 162027, "following": 7, "x_username": "GeoffO7", "canonical_svm_wallet": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "canonical_evm_wallet": "0x452a3eb1ba7ffab825ba4529a8b6a3cf9536cc9a", "group_badges": [ { "group_id": "2200eed3-6b3d-4115-9512-e4b43c839121", "username": "CATEVENGERS", "profile_image_url": "https://socialimages.pump.fun/profile-images/f779e161-0f93-49ec-b763-2142854fd005/d56f4848-b7a9-4157-9607-7856a680d6b5", "role": "OWNER" } ], "active_competition_entry": null, "evmAddress": "0x452a3eb1ba7ffab825ba4529a8b6a3cf9536cc9a", "svmAddress": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ" }, { "address": "4Bc4Ue2G37zoQCiksAvwMgXQQJFKcYQThnoHPKizAmWB", "userId": "b393b3ef-83f6-4d57-a1c5-8aad737bc572", "is_pump_user": true, "is_banned": false, "username": "vvvvvvvvvv1", "profile_image": "https://socialimages.pump.fun/profile-images/pumpatar/2/Cyan~Body-3-Green~Face-5~Sunglasses~Hairstyle-3-grey~Empty+2~...", "avatar_decoration": null, "resolved_avatar_decoration": null, "bio": null, "followers": 14377, "following": 3, "x_username": null, "canonical_svm_wallet": "4Bc4Ue2G37zoQCiksAvwMgXQQJFKcYQThnoHPKizAmWB", "canonical_evm_wallet": "0x26cca58075c406ed7c5911e196e0bcbfa38d44ab", "group_badges": [ { "group_id": "233cfbe4-c989-41ac-a880-4364dba3e18e", "username": "fnf_", "profile_image_url": "https://socialimages.pump.fun/profile-images/b393b3ef-83f6-4d57-a1c5-8aad737bc572/246b7a68-a500-402b-b8c6-16de42101e22", "role": "OWNER" } ], "active_competition_entry": null, "evmAddress": "0x26cca58075c406ed7c5911e196e0bcbfa38d44ab", "svmAddress": "4Bc4Ue2G37zoQCiksAvwMgXQQJFKcYQThnoHPKizAmWB" } ], "notFound": [] }, "meta": { "observedAt": 1793068404036, "ageMs": 14561, "source": "cache", "parts": { "usersBatch": { "observedAt": 1793068404036, "source": "cache" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` - [GET /v1/user/{user}](https://pump.x4o2.com/v1/user/{user}): A pump.fun user's profile by wallet or user id; optionally portfolio, P&L summary, balances, created coins, followers, following, achievements (0.001 USD via x402) The public profile of one pump.fun user (wallet address, user id, username, bio, follower counts, creation stats) plus their overview. Add include= with any of portfolio (open positions with P&L), summary (period P&L; period=1d|1w|1m|all), balance (wallet value and token balances), created (coins they launched), followers, following, achievements. Use to evaluate a trader seen in holders, traders or the leaderboard. Paid: 0.001 USDC per call via x402 (Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)). Unpaid requests receive 402 with payment requirements. Request body: ```json {} ``` Parameters: ```json [ { "name": "user", "in": "path", "required": true, "schema": { "type": "string", "description": "Wallet address (base58) or pump.fun user id (uuid)" }, "description": "Wallet address (base58) or pump.fun user id (uuid)", "example": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ" }, { "name": "maxAge", "in": "query", "required": false, "schema": { "type": "integer", "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "minimum": 0 }, "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed", "example": "5" }, { "name": "stale", "in": "query", "required": false, "schema": { "type": "integer", "description": "1 returns any cached copy immediately and refreshes in the background", "enum": [ 0, 1 ] }, "description": "1 returns any cached copy immediately and refreshes in the background", "example": "0" }, { "name": "include", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated extras: portfolio, summary, balance, created, followers, following, achievements" }, "description": "Comma-separated extras: portfolio, summary, balance, created, followers, following, achievements", "example": "portfolio,summary" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "P&L period for include=summary", "enum": [ "1d", "1w", "1m", "all" ] }, "description": "P&L period for include=summary", "example": "1d" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "user": { "type": [ "object", "null" ], "properties": { "address": { "type": [ "string", "null" ] }, "userId": { "type": [ "string", "null" ] }, "is_pump_user": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image": { "type": [ "string", "null" ] }, "header_image_url": { "type": [ "string", "null" ] }, "avatar_decoration": {}, "resolved_avatar_decoration": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "member_count": { "type": [ "number", "null" ] }, "active_competition_entry": {}, "last_username_update_timestamp": { "type": [ "number", "null" ] }, "following": { "type": [ "number", "null" ] }, "followers": { "type": [ "number", "null" ] }, "bio": { "type": [ "string", "null" ] }, "x_username": { "type": [ "string", "null" ] }, "canonical_svm_wallet": { "type": [ "string", "null" ] }, "canonical_evm_wallet": { "type": [ "string", "null" ] }, "group_badges": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "group_id": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image_url": { "type": [ "string", "null" ] }, "role": { "type": [ "string", "null" ] } } } } } }, "overview": { "type": [ "object", "null" ], "properties": { "address": { "type": [ "string", "null" ] }, "profile": { "type": [ "object", "null" ], "properties": { "address": { "type": [ "string", "null" ] }, "userId": { "type": [ "string", "null" ] }, "is_pump_user": { "type": [ "boolean", "null" ] }, "is_banned": { "type": [ "boolean", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image": { "type": [ "string", "null" ] }, "header_image_url": { "type": [ "string", "null" ] }, "avatar_decoration": {}, "resolved_avatar_decoration": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "member_count": { "type": [ "number", "null" ] }, "active_competition_entry": {}, "last_username_update_timestamp": { "type": [ "number", "null" ] }, "following": { "type": [ "number", "null" ] }, "followers": { "type": [ "number", "null" ] }, "bio": { "type": [ "string", "null" ] }, "x_username": { "type": [ "string", "null" ] }, "canonical_svm_wallet": { "type": [ "string", "null" ] }, "canonical_evm_wallet": { "type": [ "string", "null" ] }, "group_badges": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "group_id": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "profile_image_url": { "type": [ "string", "null" ] }, "role": { "type": [ "string", "null" ] } } } } } }, "isPumpUser": { "type": [ "boolean", "null" ] }, "counts": { "type": [ "object", "null" ], "properties": { "followers": { "type": [ "number", "null" ] }, "following": { "type": [ "number", "null" ] } } }, "verified": { "type": [ "boolean", "null" ] }, "achievementBadgeIds": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "banned": { "type": [ "boolean", "null" ] }, "createdCoinsCount": { "type": [ "number", "null" ] }, "degraded": { "type": [ "array", "null" ] } } }, "portfolio": { "type": [ "object", "null" ], "properties": { "positions": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "coinMint": { "type": [ "string", "null" ] }, "chainId": { "type": [ "number", "null" ] }, "isExited": { "type": [ "boolean", "null" ] }, "walletAddress": { "type": [ "string", "null" ] }, "amountHeld": { "type": [ "number", "null" ] }, "pnlUsd": { "type": [ "number", "null" ] }, "pnlPercentage": { "type": [ "number", "null" ] }, "costBasisAmount": { "type": [ "number", "null" ] }, "costBasisUsd": { "type": [ "number", "null" ] }, "amountBoughtUsd": { "type": [ "number", "null" ] }, "amountBought": { "type": [ "number", "null" ] }, "callout": { "type": [ "object", "null" ], "properties": { "calloutId": { "type": [ "string", "null" ] }, "chain": {}, "assetClass": { "type": [ "string", "null" ] }, "perp": {}, "calledOutAtMcap": { "type": [ "number", "null" ] }, "multiple": { "type": [ "number", "null" ] }, "thesis": { "type": [ "string", "null" ] }, "mediaUrl": {}, "calloutTimestamp": { "type": [ "string", "null" ] }, "likes": { "type": [ "number", "null" ] }, "hasLiked": {}, "updates": { "type": [ "array", "null" ] }, "updateCount": { "type": [ "number", "null" ] }, "commentCount": { "type": [ "number", "null" ] }, "replyCount": { "type": [ "number", "null" ] }, "maxMultiplier": { "type": [ "number", "null" ] }, "maxMultiplierAt": { "type": [ "string", "null" ] }, "calloutPrice": { "type": [ "number", "null" ] }, "repostCount": { "type": [ "number", "null" ] }, "quoteCount": { "type": [ "number", "null" ] }, "hasReposted": {}, "viewCount": { "type": [ "number", "null" ] }, "quotedCalloutId": {}, "quotedCallout": {}, "actingUserId": {}, "actingUser": {} } }, "hasTransfers": { "type": [ "boolean", "null" ] }, "likelyLost": { "type": [ "boolean", "null" ] }, "hasUntrustedUsdBasis": { "type": [ "boolean", "null" ] }, "hasUntrustedSolBasis": { "type": [ "boolean", "null" ] }, "valueUsd": { "type": [ "number", "null" ] }, "tokenPriceUsd": { "type": [ "number", "null" ] }, "realizedPnlUsd": { "type": [ "number", "null" ] }, "updatedAt": { "type": [ "string", "null" ] }, "lastSlotIndexId": { "type": [ "string", "null" ] }, "potentialSpam": { "type": [ "boolean", "null" ] }, "userMarkedNonSpam": { "type": [ "boolean", "null" ] }, "dustFloorFiltered": { "type": [ "boolean", "null" ] }, "isNative": { "type": [ "boolean", "null" ] }, "coin": { "type": [ "object", "null" ], "properties": { "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "imageUri": { "type": [ "string", "null" ] }, "marketCapUsd": { "type": [ "number", "null" ] }, "totalSupply": { "type": [ "number", "null" ] }, "protocol": { "type": [ "string", "null" ] }, "platform": {}, "program": { "type": [ "string", "null" ] } } } } } }, "summary": { "type": [ "object", "null" ], "properties": { "positionCount": { "type": [ "number", "null" ] }, "hlAccount": { "type": [ "string", "null" ] } } }, "updatesApplied": { "type": [ "boolean", "null" ] } } }, "summary": { "type": [ "object", "null" ], "properties": { "wallet": { "type": [ "string", "null" ] }, "from": { "type": [ "number", "null" ] }, "to": { "type": [ "number", "null" ] }, "pnl": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "realizedPnl": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "unrealizedPnl": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "percentage": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "totalBuySpend": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "heldOpenValue": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "maxCapitalDeployed": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "equityAtWindowStart": { "type": [ "object", "null" ], "properties": { "sol": {}, "usd": {} } }, "missingPriceMints": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "tokenCount": { "type": [ "number", "null" ] }, "tradePercentage": { "type": [ "object", "null" ], "properties": { "sol": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } } }, "totalValueUsd": { "type": [ "number", "null" ] }, "solPriceUsd": { "type": [ "number", "null" ] }, "nativeBalanceSol": { "type": [ "number", "null" ] }, "cache": { "type": [ "object", "null" ], "properties": { "filledAtMs": { "type": [ "number", "null" ] }, "ttlSeconds": { "type": [ "number", "null" ] } } }, "computedAt": { "type": [ "number", "null" ] }, "evmAddress": { "type": [ "string", "null" ] } } }, "balance": { "type": [ "object", "null" ], "properties": { "success": { "type": [ "boolean", "null" ] }, "data": { "type": [ "object", "null" ], "properties": { "total_value": { "type": [ "number", "null" ] }, "native_balance": { "type": [ "number", "null" ] }, "native_lamports": { "type": [ "number", "null" ] }, "wrapped_sol_balance": { "type": [ "number", "null" ] }, "sol_price": { "type": [ "number", "null" ] }, "token_count": { "type": [ "number", "null" ] }, "dust_count": { "type": [ "number", "null" ] }, "dust_value_usd": { "type": [ "number", "null" ] }, "hidden_count": { "type": [ "number", "null" ] }, "hidden_value_usd": { "type": [ "number", "null" ] }, "last_update_ts": { "type": [ "number", "null" ] }, "portfolioPnL": { "type": [ "object", "null" ], "properties": { "total_cost_basis_usd": { "type": [ "number", "null" ] }, "total_unrealized_usd": { "type": [ "number", "null" ] }, "total_percentage": { "type": [ "number", "null" ] } } } } } } }, "created": {}, "followers": {}, "following": {}, "achievements": {} } }, "meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "required": [ "data", "meta" ] }, "example": { "data": { "user": { "address": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "userId": "f779e161-0f93-49ec-b763-2142854fd005", "is_pump_user": true, "is_banned": false, "username": "SossaDotKek", "profile_image": "https://socialimages.pump.fun/profile-images/2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ/1483b61e-df0d-4b93-a3d4-161...", "header_image_url": "https://images.pump.fun/6b0fc278-d541-400d-48d8-5d5bd2232300?variant=profiles", "avatar_decoration": null, "resolved_avatar_decoration": "epic", "kind": "person", "member_count": 0, "active_competition_entry": null, "last_username_update_timestamp": 1786803263858, "following": 7, "followers": 162027, "bio": "Hodler by nature", "x_username": "GeoffO7", "canonical_svm_wallet": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "canonical_evm_wallet": "0x452a3eb1ba7ffab825ba4529a8b6a3cf9536cc9a", "group_badges": [ { "group_id": "2200eed3-6b3d-4115-9512-e4b43c839121", "username": "CATEVENGERS", "profile_image_url": "https://socialimages.pump.fun/profile-images/f779e161-0f93-49ec-b763-2142854fd005/d56f4848-b7a9-4157-9607-7856a680d6b5", "role": "OWNER" } ] }, "overview": { "address": "f779e161-0f93-49ec-b763-2142854fd005", "profile": { "address": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "userId": "f779e161-0f93-49ec-b763-2142854fd005", "is_pump_user": true, "is_banned": false, "username": "SossaDotKek", "profile_image": "https://socialimages.pump.fun/profile-images/2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ/1483b61e-df0d-4b93-a3d4-161...", "header_image_url": "https://images.pump.fun/6b0fc278-d541-400d-48d8-5d5bd2232300?variant=profiles", "avatar_decoration": null, "resolved_avatar_decoration": "epic", "kind": "person", "member_count": 0, "active_competition_entry": null, "last_username_update_timestamp": 1786803263858, "following": 7, "followers": 162027, "bio": "Hodler by nature", "x_username": "GeoffO7", "canonical_svm_wallet": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "canonical_evm_wallet": "0x452a3eb1ba7ffab825ba4529a8b6a3cf9536cc9a", "group_badges": [ { "group_id": "2200eed3-6b3d-4115-9512-e4b43c839121", "username": "CATEVENGERS", "profile_image_url": "https://socialimages.pump.fun/profile-images/f779e161-0f93-49ec-b763-2142854fd005/d56f4848-b7a9-4157-9607-7856a680d6b5", "role": "OWNER" } ] }, "isPumpUser": true, "counts": { "followers": 162027, "following": 7 }, "verified": false, "achievementBadgeIds": [ "views-1m", "followers-100k" ], "banned": false, "createdCoinsCount": 4, "degraded": [] }, "portfolio": { "positions": [ { "coinMint": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "chainId": 1399811149, "isExited": false, "walletAddress": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "amountHeld": 20730476.396162, "pnlUsd": 466794.9566433995, "pnlPercentage": 95.98060767671657, "costBasisAmount": 20730476.39611597, "costBasisUsd": 486342.9894251824, "amountBoughtUsd": 356240.85633483774, "amountBought": 14413072.671784988, "callout": { "calloutId": "c80441e0-f76e-4bc6-8672-8419a9383529", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 27728837, "multiple": 1.5990467289586163, "thesis": "I'm back 100x the Cate", "mediaUrl": null, "calloutTimestamp": "2026-08-04T03:30:32.325Z", "likes": 607, "hasLiked": null, "updates": [ { "id": "fc033446-8e19-4ed3-a342-7ff7e03ab8ac", "content": "Join the tiktok live for a hot chip challenge by pickle and tristin, Cate community locking in \n\nhttps://vt.tiktok.co...", "createdAt": "2026-10-24T17:49:17.599Z", "likeCount": 9, "mediaUrl": null, "parentMessageId": null, "repostCount": 0, "viewCount": 2393 } ], "updateCount": 127, "commentCount": 84, "replyCount": 211, "maxMultiplier": 4.541219206305773, "maxMultiplierAt": "2026-09-19T20:29:33.664Z", "calloutPrice": 0.0287531428558, "repostCount": 30, "quoteCount": 0, "hasReposted": null, "viewCount": 583986, "quotedCalloutId": null, "quotedCallout": null, "actingUserId": null, "actingUser": null }, "hasTransfers": true, "likelyLost": false, "hasUntrustedUsdBasis": false, "hasUntrustedSolBasis": false, "valueUsd": 953137.9460706982, "tokenPriceUsd": 0.045977619030846795, "realizedPnlUsd": 0, "updatedAt": "2026-10-24T20:17:34.000Z", "lastSlotIndexId": "00046098300500002100000008", "potentialSpam": false, "userMarkedNonSpam": false, "dustFloorFiltered": false, "isNative": false, "coin": { "name": "Catecoin", "symbol": "CATE", "imageUri": "https://imagedelivery.net/WL1JOIJiM_NAChp6rtB6Cw/coin-image/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "marketCapUsd": 45977619.0308468, "totalSupply": 1000000000, "protocol": "pump", "platform": null, "program": "pump" } }, { "coinMint": "tqhtQ1bzuUzhqFnq9b5TD7ViDRsMxVk81KTATG3YAhk", "chainId": 1399811149, "isExited": false, "walletAddress": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "amountHeld": 225552991.651823, "pnlUsd": 27286.880946711626, "pnlPercentage": null, "costBasisAmount": 225552991.65182298, "costBasisUsd": 0, "amountBoughtUsd": 0, "amountBought": 0, "callout": null, "hasTransfers": true, "likelyLost": false, "hasUntrustedUsdBasis": false, "hasUntrustedSolBasis": false, "valueUsd": 27286.88094671163, "tokenPriceUsd": 0.000120977694629, "realizedPnlUsd": 0, "updatedAt": "2026-09-02T09:13:28.000Z", "lastSlotIndexId": "00044365962906553500000011", "potentialSpam": true, "userMarkedNonSpam": false, "dustFloorFiltered": false, "isNative": false, "coin": { "name": "Doge", "symbol": "mɔ", "imageUri": "https://token-media.defined.fi/1399811149_tqhtQ1bzuUzhqFnq9b5TD7ViDRsMxVk81KTATG3YAhk_small_db58f5e75e37.png", "marketCapUsd": 120677632.06527002, "totalSupply": 997519686875.7487, "protocol": null, "platform": null, "program": null } } ], "summary": { "positionCount": 541, "hlAccount": "missing" }, "updatesApplied": true }, "summary": { "wallet": "2M2vLX34LXMg24dMEnjWHvRXS1tshpEDRWzmXgV8ENNZ", "from": 1792980000, "to": 1793068380, "pnl": { "sol": -784.6281733632213, "usd": -85723.59008004412 }, "realizedPnl": { "sol": -44.76614129564803, "usd": -4507.630723420416 }, "unrealizedPnl": { "sol": -739.8620320675733, "usd": -81215.9593566237 }, "percentage": { "sol": -7.438126018272796, "usd": -8.027940152858823 }, "totalBuySpend": { "sol": 131.25375132, "usd": 13224.763675322585 }, "heldOpenValue": { "sol": 10544.126443686986, "usd": 1067362.0243514185 }, "maxCapitalDeployed": { "sol": 10548.734606481155, "usd": 1067815.5099289967 }, "equityAtWindowStart": { "sol": null, "usd": null }, "missingPriceMints": [ "5A5Yfp5XJWPzwTYBzjRmgowUA7A8G5sMjw93rrquPbZw", "AW1vmJVbE47go5JDUTc4qngNUvjm531kCTvAYuNrgjRX" ], "tokenCount": 29, "tradePercentage": { "sol": -7.438126018272796, "usd": -8.027940152858823 }, "totalValueUsd": 980539.127943085, "solPriceUsd": 100.26885988738384, "nativeBalanceSol": 33.968264642, "cache": { "filledAtMs": 1793068392063, "ttlSeconds": 30 }, "computedAt": 1793068392063, "evmAddress": "0x452a3eb1ba7ffab825ba4529a8b6a3cf9536cc9a" }, "balance": { "success": true, "data": { "total_value": 980018.0584069501, "native_balance": 33.968264642, "native_lamports": 33968264642, "wrapped_sol_balance": 0, "sol_price": 100.26885988738384, "token_count": 186, "dust_count": 257, "dust_value_usd": 3.9054298307188184, "hidden_count": 33, "hidden_value_usd": 399.91070713823035, "last_update_ts": 1793068302, "portfolioPnL": { "total_cost_basis_usd": 1046732.0369488585, "total_unrealized_usd": -66713.97854190844, "total_percentage": -6.3735489300943176 } } }, "created": null, "followers": null, "following": null, "achievements": null }, "meta": { "observedAt": 1793068418597, "ageMs": 517, "source": "fresh", "parts": { "user": { "observedAt": 1793068418597, "source": "fresh" }, "userOverview": { "observedAt": 1793068418625, "source": "fresh" }, "portfolio": { "observedAt": 1793068418625, "source": "fresh" }, "portfolioSummary": { "observedAt": 1793068418625, "source": "fresh" }, "balanceSummary": { "observedAt": 1793068418625, "source": "fresh" } } } } } } }, "400": { "description": "Invalid mint, user or query: { error, message } with error such as invalid_mint, invalid_period, invalid_wallets, rejected (pump.fun refused the parameters) or unknown_parameter (a query key this route does not accept; parameter and allowed name it)" }, "402": { "description": "Payment Required; x4o2-free-key extension describes free key signup and Authorization header" }, "409": { "description": "payment_in_flight: this payment is already being used by another request" }, "429": { "description": "Free key over its limit: minute_quota_exceeded, daily_quota_exceeded (resets 00:00 UTC) or free_tier_paused; honour Retry-After or pay per call; upgrade includes price, networks, payment instructions, discovery, docs and UTC daily reset. Link points to docs. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows" }, "502": { "description": "unavailable: pump.fun answered with an error; retry shortly" }, "503": { "description": "busy or unavailable: temporarily out of upstream capacity; honour Retry-After or pass stale=1" } } ``` ## Shared schemas ```json { "schemas": { "Meta": { "type": "object", "description": "Freshness of the response", "properties": { "observedAt": { "type": "integer", "description": "Unix ms when the oldest part was observed upstream" }, "ageMs": { "type": "integer", "description": "Age of the oldest part when served, ms" }, "source": { "type": "string", "enum": [ "cache", "fresh", "stale" ] }, "parts": { "type": "object", "description": "observedAt and source per upstream part" } }, "required": [ "observedAt", "ageMs", "source" ] } }, "securitySchemes": { "apiKey": { "type": "http", "scheme": "bearer", "description": "Free API key from https://x4o2.com/keys (email login): 60 requests a minute and 1,000 a UTC day per key and service, served while the service has spare capacity, else 429 (minute_quota_exceeded, daily_quota_exceeded, free_tier_paused) with Retry-After; paid x402 requests always go through." } } } ```