PLAGUES API

Returns token cards aggregated by smart money wallet activity for a given time period. Each card includes token identity, market metrics, smart wallet contributors, and their flow direction (buy/sell/net inflow). Use this to discover which tokens smart wallets are accumulating or exiting.

Parallel to the smart money cards endpoint but filtered to Key Opinion Leader (KOL) wallet activity. Same period contract and card structure. Use this to track which tokens influential wallets are positioning in, independently from smart money signals.

Returns a ranked list of tokens sorted by swap activity for the specified period. Each row includes comprehensive safety data (honeypot status, mint/freeze renounce, burn ratio), distribution risk (rat trader rate, bundler rate, sniper hold rate), and smart presence indicators. This is the primary market-wide ranking feed.

Backup discovery source returning newly created trading pairs. Includes nested token stats snapshots within base_token_info. Useful for catching tokens that haven't yet appeared in smart money or rank feeds. Supports common safety filters.

Token signal feed for migration and graduation events (e.g., Pump.fun bond curve completion). Returns event timing, trigger market cap, and rich token snapshots including safety, holder, and social data. Subscribe to specific signal types and launchpad platforms.

Real-time trade stream from smart money wallets. Each trade includes transaction hash, wallet address, token, side (buy/sell), USD amount, and enriched wallet metadata (name, avatar, tags, Twitter). Use this for live flow monitoring and copy-trading signals.

Parallel to smart money trades but filtered to KOL wallets. Same structure with transaction detail and wallet metadata. Track influencer trading activity independently or merge with smart money flow for conviction scoring.

Returns top buyer profiles for a specific token. Includes aggregated holder status breakdown (holding, bought more, sold part, sold out) and individual wallet info with tags. Useful for conviction analysis on specific tokens.

Comprehensive token distribution and risk summary. Returns holder concentration (top-10 holder rate), bot/degen counts and rates, fresh wallet rate, dev/team/creator hold rates, and private vault exposure. Essential first-call for any token risk assessment.

Breakdown of a token's holder base by wallet classification tags. See how many smart wallets, fresh wallets, renowned wallets, creator wallets, sniper wallets, bundler wallets, and top wallets are positioned in a token. Useful for quick conviction scoring and bot activity detection.

Aggregated holder segmentation by wallet type. Returns counts for smart degen, renowned, fresh wallet, DEX bot, insider, following, dev, bluechip owner, bundler, and sniper categories. Complementary to wallet-tags for deeper holder profiling.

Paginated list of token holders with full position detail. Each row includes balance, USD value, percentage of supply, realized and unrealized PnL, net flow, buy/sell volumes, wallet tags, and last active timestamp. Supports cursor-based pagination.

Chronological trade history for a token. Each trade includes event type (buy/sell), maker wallet, amounts in USD/base/quote, price, timestamp, transaction hash, and maker tags. Supports pagination and row limits.

Active trader list for a token with the same general structure as the holders endpoint, focused on recent trader activity. Includes position values, PnL, net flow, tags, and pagination support.

Aggregated trader segmentation by wallet type. Same category breakdown as holder-stat but focused on active traders rather than all holders. Useful for understanding who is actively trading a token versus passively holding.

Top buyer profiles with aggregated holder status breakdown (holding, bought more, sold part, sold out, transferred) and individual wallet info with tags. Includes sniper hold rate and top-10 holder concentration from the status snapshot.

Pool-level liquidity and fee configuration for a token. Returns exchange info, liquidity amount, fee ratio, pool type, and detailed fee parameters. Critical for execution planning and slippage estimation.

OHLCV candlestick data denominated in market cap. Supports multiple resolutions from 1-minute to 1-day. Each candle includes time, open, high, low, close, volume, and amount. Essential for charting and technical analysis on market cap basis.

OHLCV candlestick data denominated in token price. Same query conventions and response structure as mcap-candles. Use for standard price-based charting and TA.

Execution slippage guidance for a token. Returns recommended buy and sell slippage, display slippage, tax flag, and volatility measure. Critical for automated trading to avoid failed transactions or excessive MEV extraction.

Combined security audit and launchpad status for a token. Security section covers honeypot detection, mint/freeze renounce status, burn ratio, buy/sell tax, and lock summary. Launchpad section covers platform, migration status, progress, and target pool exchange. One-call due diligence endpoint.

Aggregate PnL and risk snapshot for a wallet by time period. Returns realized profit, unrealized profit, total profit with PnL percentages, buy/sell counts, transfer activity, total fees, and a risk score. The recommended source for wallet-level performance reporting.

Transaction-level activity stream for a wallet. Returns individual trades with tx hash, event type, token amounts, quote amounts, cost in USD, price, gas and DEX fees, and addresses involved. Supports cursor pagination for deep history.

Enriched smart wallet profile with identity, social, balance, PnL, and quality metrics. Includes name, avatar, ENS, tags, Twitter info, SOL balance, total portfolio value, realized/unrealized PnL across timeframes, win rate, and token count. The definitive wallet intelligence endpoint.

Wallet-specific position metrics for a single token. Requires token_address query param. Returns balance, total value, PnL with percentage, buy/sell counts, average holding period, cost basis history, and wallet token tags. Use for deep position analysis on a specific wallet-token pair.

Per-token holdings list for a wallet with full position detail. Returns balance, USD value, accumulated cost, realized/unrealized PnL, holding period, and token metadata. Supports sorting, filtering (hide airdrops, closed positions, small balances), and 30-day PnL mode. Requires specific query params — calling without them returns an error.

Complete coin metadata including name, symbol, description, image URI, social links (Twitter, Telegram, website), bonding curve addresses, creator, creation timestamp, completion status, virtual/real SOL and token reserves, market cap, ATH, reply count, live stream status, and program type. The primary coin lookup endpoint.

Platform-recommended coins list with full metadata per token. Supports NSFW filtering and result limits. Returns array of coin objects with the same fields as the single coin endpoint. Use for discovery and trending token feeds.

Top-performing coins currently leading on the launchpad. Returns array of objects with nested coin metadata and performance indicators. Use for real-time leaderboard and trending tracking.

Batch lookup for multiple coins in a single request. Returns array of coin objects with full metadata. More efficient than individual calls when you need data for several tokens at once.

Community chat room metadata for a coin. Returns chat ID, room name, description, avatar, member count, membership status, invite link, and token-gate configuration (minimum hold amount, gate address). Use for social sentiment and community size tracking.

Returns the all-time high market cap for a launchpad coin. Simple but essential for relative performance tracking and entry timing.

Multi-timeframe market activity snapshot. Returns transaction count, volume in USD, user count, buy/sell counts, and price change percentage across 5-minute, 1-hour, 6-hour, and 24-hour windows. Ideal for real-time activity monitoring dashboards.

OHLCV candlestick data for launchpad coins. Returns timestamp, open, high, low, close, and volume per candle. Supports multiple intervals for flexible charting.

Paginated trade history for a launchpad coin. Each trade includes slot index, transaction hash, timestamp, user address, trade type (buy/sell), program, price in USD and SOL, and amount in USD. Supports cursor-based pagination for deep trade history retrieval.

Batch trade history lookup across multiple coins. Returns a map keyed by token address with trade arrays. More efficient than individual trade calls when monitoring multiple tokens simultaneously.

Batch all-time high market cap lookup across multiple tokens. Returns a map keyed by mint address with ATH values. Efficient for portfolio-level performance tracking.

Batch multi-window market activity across multiple tokens. Returns a map keyed by mint address with the same activity structure as the single-token endpoint. Efficient for monitoring multiple coins on a dashboard.

Top holder addresses with their token amounts and SOL balances for a launchpad coin. Also returns total holder count. Useful for whale tracking and concentration analysis on launchpad tokens.

Comment/reply stream for a coin. Each reply includes transaction signature, buy flag, SOL amount, mint, text content, user info, timestamp, and like count. Paginated with offset. Useful for social sentiment and community engagement metrics.

Launchpad user profile with address, username, profile image, bio, follower/following counts, likes and mentions received, and linked X (Twitter) identity.

List of coins created by a specific user address. Returns count, pagination info, and coin objects with mint, name, symbol, creator, creation timestamp, market cap, reply count, and live status.

List of users that a given address follows. Returns username, profile image, address, follow timestamp, and follower count for each entry.

List of followers for a given address. Same structure as following list. Use for social graph analysis and influence mapping.

Batch user profile lookup. Returns array of user objects with address, username, profile image, bio, follower and following counts.

Aggregate portfolio balance summary. Returns total value, native SOL balance, SOL price, token count, last update timestamp, and portfolio PnL overview. Quick wallet valuation endpoint.

Detailed per-token balance list. Each entry includes token mint, name, symbol, price, decimals, balance, value, and token-level PnL with cost basis, unrealized value, and percentage. Comprehensive portfolio breakdown.

Current SOL price feed. Returns the real-time Solana native token price. Essential for USD conversions and portfolio valuations.

Global launchpad parameters including current slot, signature, initial virtual/real reserves, token total supply, fee basis points, and timestamp. Use for bonding curve calculations and launch configuration reference.

Livestream clips for a coin. Returns clip ID, session ID, start/end times, duration, playlist URL, thumbnail, title, clip type, view count, and pagination cursor. Supports filtering by clip type (HIGHLIGHT, COMPLETE).

Aggregate clip counts for a coin. Returns total, hidden, visible, and soft-deleted clip counts. Quick metrics for content engagement tracking.

Top-performing VOD (video on demand) content across the platform. Returns VOD ID, total views, and room name for each entry. Useful for trending content discovery.

Batch livestream playlist lookup. Returns a map keyed by token address with playlist key, URL, status, and timestamps (updated, started, ended). Efficient for monitoring multiple live streams simultaneously.

WebSocket realtime event stream for live market intelligence. Receive trade events, price updates, new token launches, graduation signals, and smart money flow as they happen. Built on Socket.IO protocol with EIO=4 transport. All plans include WebSocket access with the same 1,500 req/min rate limit.