# 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 is pay-per-call via x402.

- Price: 0.001 USDC per call, network eip155:8453
- Docs: https://pump.x4o2.com/
- OpenAPI: https://pump.x4o2.com/openapi.json
- Freshness: every route accepts maxAge=<seconds> and stale=1; responses carry meta.observedAt, meta.ageMs, meta.source
- Free API key for testing: https://x4o2.com/keys (Authorization: Bearer <key>; served while there is spare capacity, else 429 Retry-After)
- Coins are identified by Solana mint address; users by wallet address or pump.fun user id

## Routes

- GET https://pump.x4o2.com/v1/coin/:mint: pump.fun coin overview: metadata, market cap, price, volume, buy/sell stats, ATH, holder count
- GET https://pump.x4o2.com/v1/coin/:mint/holders: Top holders of a pump.fun coin with username, position size, cost basis and P&L
- GET 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
- GET https://pump.x4o2.com/v1/coin/:mint/trades: Recent trades on a pump.fun coin: buyer/seller, SOL and USD size, price, signature
- GET https://pump.x4o2.com/v1/coin/:mint/candles: OHLCV candles for a pump.fun coin in USD or SOL, price or market cap
- GET https://pump.x4o2.com/v1/coins/trending: pump.fun trending board: the coins moving right now with market cap, volume and price change
- GET https://pump.x4o2.com/v1/coins/feed: pump.fun home feed: ranked coins with market cap, protocol, creator and recent activity
- GET https://pump.x4o2.com/v1/coins/live: Coins currently livestreaming on pump.fun, with viewer counts and market data
- GET https://pump.x4o2.com/v1/coins/search: Search pump.fun coins by name, ticker or mint
- GET https://pump.x4o2.com/v1/coins: List pump.fun coins sorted by market cap, creation time, last trade or reply count
- GET https://pump.x4o2.com/v1/leaderboard: pump.fun P&L leaderboard: top wallets by realized and unrealized profit over a period
- GET 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

## Example

GET https://pump.x4o2.com/v1/coin/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump/holders