MAD Synapse · Pump & LP
Every pump.fun curve trade since 09-11: tape, launches, forensics, devs, odds + Meteora DLMM pools.
Should I use this
Quality & Safety
Findings (5)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin pump_launches
- MEDIUMTool description contains URL to non-standard domainin pump_token
- MEDIUMTool description contains URL to non-standard domainin pump_wallet
- MEDIUMTool description contains URL to non-standard domainin pump_odds
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"synapse-pump": {
"url": "https://agent.maddegen.art/hub/mcp/pump"
}
}
}Remote endpoints
https://agent.maddegen.art/hub/mcp/pumpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢pump_pulse
Live pump.fun heartbeat: trades/min, launches, graduations, graduation rate, hottest tokens in the last 15 min. Computed from our own live recording of every pump.fun bonding-curve trade. Use it to decide whether the launch market is hot or dead before scanning individual tokens. When to use: For the market right now; for trends over days use pump_history. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"sol_usd": {
"type": [
"number",
"null"
]
},
"trades_per_min": {
"type": [
"number",
"null"
]
},
"last_hour": {
"type": [
"object",
"null"
],
"properties": {
"trades": {
"type": [
"number",
"null"
]
},
"sol_volume": {
"type": [
"number",
"null"
]
},
"unique_wallets": {
"type": [
"number",
"null"
]
},
"active_tokens": {
"type": [
"number",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
}
}
},
"last_24h": {
"type": [
"object",
"null"
],
"properties": {
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
},
"graduation_rate_pct": {
"type": [
"number",
"null"
]
}
}
},
"hottest_15m": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"buy_sol": {
"type": [
"number",
"null"
]
},
"sell_sol": {
"type": [
"number",
"null"
]
},
"net_sol": {
"type": [
"number",
"null"
]
},
"wallets": {
"type": [
"number",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
}
}
}
},
"recent_graduations": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"graduated_at": {
"type": [
"string",
"null"
]
}
}
}
},
"coverage": {
"type": [
"string",
"null"
]
}
}
}🟢pump_history(granularity, from, to, compare_from, compare_to)
pump.fun over time: launches, graduations, graduation rate, trades, SOL volume and unique wallets per day or hour since 2026-09-11 — with a compare window. The same tape as pump_pulse, sliced into UTC days or hours so an agent can compare the market over time instead of reading one snapshot. Pass compare_from/compare_to to get a second window and the per-period change (e.g. this week vs last week). Closed periods are precomputed from our own live recording of every bonding-curve trade; the open period is marked partial. Also reports the share of trades made by pump.fun's own mayhem agent, so it can be separated from real demand. When to use: For trends over days or hours; for the last 15 minutes use pump_pulse. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"granularity": {
"type": "string",
"pattern": "^(day|hour)$",
"default": "day",
"description": "Bucket size: \"day\" or \"hour\". Default \"day\"."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}(:\\d{2}){0,2}Z?)?$",
"description": "UTC start, e.g. 2026-09-18 or 2026-09-18T06 (default: 14 days / 48 hours back)"
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}(:\\d{2}){0,2}Z?)?$",
"description": "UTC end, inclusive (default: now)"
},
"compare_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}(:\\d{2}){0,2}Z?)?$",
"description": "start of a second window to compare against"
},
"compare_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}(:\\d{2}){0,2}Z?)?$",
"description": "end of the comparison window, inclusive"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"granularity": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"rows": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"period": {
"type": [
"string",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
},
"graduation_rate_pct": {
"type": [
"number",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
},
"buy_share_pct": {
"type": [
"number",
"null"
]
},
"sol_volume": {
"type": [
"number",
"null"
]
},
"unique_wallets": {
"type": [
"number",
"null"
]
},
"active_tokens": {
"type": [
"number",
"null"
]
},
"mayhem_agent_trade_pct": {
"type": [
"number",
"null"
]
}
}
}
},
"summary": {
"type": [
"object",
"null"
],
"properties": {
"periods": {
"type": [
"number",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"to": {
"type": [
"string",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
},
"graduation_rate_pct": {
"type": [
"number",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
},
"sol_volume": {
"type": [
"number",
"null"
]
},
"avg_unique_wallets_per_day": {
"type": [
"number",
"null"
]
}
}
},
"definitions": {
"type": [
"object",
"null"
],
"properties": {
"graduation_rate_pct": {
"type": [
"string",
"null"
]
},
"mayhem_agent_trade_pct": {
"type": [
"string",
"null"
]
},
"partial": {
"type": [
"string",
"null"
]
},
"unique_wallets": {
"type": [
"string",
"null"
]
}
}
},
"coverage": {
"type": [
"string",
"null"
]
},
"compare": {
"type": [
"object",
"null"
],
"properties": {
"against": {
"type": [
"object",
"null"
],
"properties": {
"periods": {
"type": [
"number",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"to": {
"type": [
"string",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
},
"graduation_rate_pct": {
"type": [
"number",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
},
"sol_volume": {
"type": [
"number",
"null"
]
},
"avg_unique_wallets_per_day": {
"type": [
"number",
"null"
]
}
}
},
"change_pct_per_period": {
"type": [
"object",
"null"
],
"properties": {
"launches": {
"type": [
"number",
"null"
]
},
"graduations": {
"type": [
"number",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
},
"sol_volume": {
"type": [
"number",
"null"
]
}
}
},
"graduation_rate_change_pts": {
"type": [
"number",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
}
}
}
}
}🟢pump_launches(limit, window_s)
The newest pump.fun tokens with dev buy, early buyers/volume, curve progress, market cap and creator launch count. Returns up to 50 of the most recent launches (seconds old) with the first-N-seconds flow already aggregated, so an agent can shortlist without replaying the chain. When to use: To discover new mints; then use launch_scan (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk) for a verdict on one of them. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "How many of the newest launches to return. Range 1-50. Default 20."
},
"window_s": {
"type": "integer",
"minimum": 30,
"maximum": 3600,
"default": 300,
"description": "early-flow window after creation. Range 30-3600. Default 300."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"window_s": {
"type": [
"number",
"null"
]
},
"launches": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"creator": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"age_s": {
"type": [
"number",
"null"
]
},
"mayhem": {
"type": [
"boolean",
"null"
]
},
"token_program": {
"type": [
"string",
"null"
]
},
"dev_buy_sol": {},
"dev_sold_sol": {},
"early": {
"type": [
"object",
"null"
]
},
"curve_progress_pct": {
"type": [
"number",
"null"
]
},
"mcap_sol": {},
"mcap_usd": {},
"creator_launches": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢pump_token(mint)
Full bonding-curve forensics for one pump.fun mint: flow, dev buys/sells, launch snipers, top curve holders, peak, graduation, red flags. Aggregates every recorded curve trade of the token: unique wallets, buy/sell SOL, first-60-second flow, whether the dev sold out, non-dev wallets that bought in the launch slots (bundles), top net holders on the curve, peak market cap and post-graduation liquidity. When to use: For raw curve forensics on one mint. For a single scored verdict use launch_scan (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk); for a contract/liquidity safety grade (also after graduation) use token_risk (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk); for the creator's track record use pump_dev. Price: $0.01 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "pump.fun token mint. Base58 Solana address, 32-44 chars."
}
},
"required": [
"mint"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"creator": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"mayhem": {
"type": [
"boolean",
"null"
]
},
"token_program": {
"type": [
"string",
"null"
]
},
"socials": {},
"curve": {
"type": [
"object",
"null"
],
"properties": {
"progress_pct": {
"type": [
"number",
"null"
]
},
"price_sol": {},
"real_sol_in_curve": {
"type": [
"number",
"null"
]
},
"graduated": {
"type": [
"boolean",
"null"
]
},
"graduated_at": {},
"mcap_sol": {},
"mcap_usd": {},
"peak": {
"type": [
"object",
"null"
],
"properties": {
"mcap_sol": {},
"mcap_usd": {}
}
}
}
},
"flow": {
"type": [
"object",
"null"
],
"properties": {
"trades": {
"type": [
"number",
"null"
]
},
"buys": {
"type": [
"number",
"null"
]
},
"sells": {
"type": [
"number",
"null"
]
},
"unique_wallets": {
"type": [
"number",
"null"
]
},
"buy_sol": {
"type": [
"number",
"null"
]
},
"sell_sol": {
"type": [
"number",
"null"
]
},
"net_sol": {
"type": [
"number",
"null"
]
},
"first_trade": {
"type": [
"string",
"null"
]
},
"last_trade": {
"type": [
"string",
"null"
]
}
}
},
"first_60s": {
"type": [
"object",
"null"
],
"properties": {
"trades": {
"type": [
"number",
"null"
]
},
"unique_buyers": {
"type": [
"number",
"null"
]
},
"buy_sol": {
"type": [
"number",
"null"
]
},
"sell_sol": {
"type": [
"number",
"null"
]
}
}
},
"dev": {
"type": [
"object",
"null"
],
"properties": {
"bought_sol": {
"type": [
"number",
"null"
]
},
"sold_sol": {
"type": [
"number",
"null"
]
},
"holds_pct": {
"type": [
"number",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduated": {
"type": [
"number",
"null"
]
}
}
},
"launch_snipers": {
"type": [
"object",
"null"
],
"properties": {
"wallets": {
"type": [
"number",
"null"
]
},
"bought_sol": {
"type": [
"number",
"null"
]
},
"still_hold_pct": {
"type": [
"number",
"null"
]
}
}
},
"top_curve_holders": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"wallet": {
"type": [
"string",
"null"
]
},
"pct": {
"type": [
"number",
"null"
]
},
"label": {}
}
}
},
"post_graduation": {},
"flags": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"note": {
"type": [
"string",
"null"
]
},
"swap_url": {}
}
}🟢pump_wallet(wallet, limit)
Any wallet's pump.fun trading record: realized PnL, win rate, hold time, frequency (bot or human), tokens it launched. Analyses up to the last 20,000 curve trades of the wallet. Use it to judge whether a wallet is smart money, a sniper bot, a serial dumper or a dev. When to use: For a trader's pump.fun performance. For a quick deal/no-deal verdict on any wallet use counterparty_check (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk); to test whether copying it pays use copy_backtest. Price: $0.01 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "wallet address. Base58 Solana address, 32-44 chars."
},
"limit": {
"type": "integer",
"minimum": 100,
"maximum": 20000,
"default": 20000,
"description": "How many of the wallet's most recent recorded trades to analyse. Range 100-20000. Default 20000."
}
},
"required": [
"wallet"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"wallet": {
"type": [
"string",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"window": {
"type": [
"object",
"null"
],
"properties": {
"trades_analyzed": {
"type": [
"number",
"null"
]
},
"truncated": {
"type": [
"boolean",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"to": {
"type": [
"string",
"null"
]
}
}
},
"activity": {
"type": [
"object",
"null"
],
"properties": {
"buys": {
"type": [
"number",
"null"
]
},
"sells": {
"type": [
"number",
"null"
]
},
"tokens_traded": {
"type": [
"number",
"null"
]
},
"unpriced_tokens": {
"type": [
"number",
"null"
]
},
"buy_sol": {
"type": [
"number",
"null"
]
},
"sell_sol": {
"type": [
"number",
"null"
]
},
"avg_buy_sol": {
"type": [
"number",
"null"
]
},
"trades_per_day": {
"type": [
"number",
"null"
]
}
}
},
"closed_positions": {
"type": [
"object",
"null"
],
"properties": {
"count": {
"type": [
"number",
"null"
]
},
"win_rate_pct": {
"type": [
"number",
"null"
]
},
"realized_pnl_sol": {
"type": [
"number",
"null"
]
},
"median_hold_s": {
"type": [
"number",
"null"
]
},
"best": {
"type": [
"number",
"null"
]
},
"worst": {
"type": [
"number",
"null"
]
}
}
},
"classification": {
"type": [
"string",
"null"
]
},
"created_tokens": {
"type": [
"object",
"null"
],
"properties": {
"count": {
"type": [
"number",
"null"
]
},
"graduated": {
"type": [
"number",
"null"
]
},
"recent": {
"type": "array"
}
}
},
"recent_tokens": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"bought_sol": {
"type": [
"number",
"null"
]
},
"sold_sol": {
"type": [
"number",
"null"
]
},
"pnl_sol": {},
"status": {
"type": [
"string",
"null"
]
},
"last_trade": {
"type": [
"string",
"null"
]
}
}
}
},
"note": {
"type": [
"string",
"null"
]
}
}
}🟢pump_dev(creator)
A creator wallet's launch history: launches, graduation rate, launch cadence, how fast the dev sells, verdict. Looks up every token the wallet created since recording began and replays the dev's own trades on its 15 most recent launches. When to use: For the creator of a token; pass the dev wallet, not the mint (pump_token reports the dev of a mint). Price: $0.01 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"creator": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "creator (dev) wallet. Base58 Solana address, 32-44 chars."
}
},
"required": [
"creator"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"creator": {
"type": [
"string",
"null"
]
},
"launches": {
"type": [
"number",
"null"
]
},
"graduated": {
"type": [
"number",
"null"
]
},
"graduation_rate_pct": {
"type": [
"number",
"null"
]
},
"launches_last_24h": {
"type": [
"number",
"null"
]
},
"median_gap_between_launches_s": {
"type": [
"number",
"null"
]
},
"first_launch": {
"type": [
"string",
"null"
]
},
"last_launch": {
"type": [
"string",
"null"
]
},
"verdict": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"recent_launches": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"graduated": {
"type": [
"boolean",
"null"
]
},
"trades": {
"type": [
"number",
"null"
]
},
"unique_wallets": {
"type": [
"number",
"null"
]
},
"volume_sol": {
"type": [
"number",
"null"
]
},
"peak_mcap_sol": {
"type": [
"number",
"null"
]
},
"dev_bought_sol": {
"type": [
"number",
"null"
]
},
"dev_sold_sol": {
"type": [
"number",
"null"
]
},
"dev_first_sell_after_s": {
"type": [
"number",
"null"
]
}
}
}
},
"baseline": {
"type": [
"string",
"null"
]
}
}
}🟢pump_odds(mint)
Probability a pump.fun launch graduates, from how comparable launches in our tape actually ended — with the lift over the ~3% base rate. Buckets the launch's first 60 seconds (unique buyers, buy SOL, dev buy) and returns the empirical graduation rate of thousands of comparable recent launches whose outcome is known, shrunk toward coarser buckets when samples are thin. Rebuilt every 6 hours. When to use: For graduation probability only; launch_scan (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk) includes it alongside the other checks. Price: $0.01 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "pump.fun token mint. Base58 Solana address, 32-44 chars."
}
},
"required": [
"mint"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"age_s": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"curve_progress_pct": {
"type": [
"number",
"null"
]
},
"launch_minute": {
"type": [
"object",
"null"
],
"properties": {
"unique_buyers": {
"type": [
"number",
"null"
]
},
"buy_sol": {
"type": [
"number",
"null"
]
},
"dev_buy_sol": {
"type": [
"number",
"null"
]
}
}
},
"graduation": {
"type": [
"object",
"null"
],
"properties": {
"probability_pct": {
"type": [
"number",
"null"
]
},
"base_rate_pct": {
"type": [
"number",
"null"
]
},
"lift": {
"type": [
"number",
"null"
]
},
"comparable_launches": {
"type": [
"number",
"null"
]
},
"cell": {
"type": [
"string",
"null"
]
},
"bucket": {
"type": [
"object",
"null"
],
"properties": {
"unique_buyers_60s": {
"type": [
"string",
"null"
]
},
"buy_sol_60s": {
"type": [
"string",
"null"
]
},
"dev_buy_sol": {
"type": [
"string",
"null"
]
}
}
}
}
},
"model": {
"type": [
"object",
"null"
],
"properties": {
"built_at": {
"type": [
"string",
"null"
]
},
"sample": {
"type": [
"number",
"null"
]
},
"base_rate_pct": {
"type": [
"number",
"null"
]
},
"window": {
"type": [
"string",
"null"
]
}
}
},
"method": {
"type": [
"string",
"null"
]
},
"swap_url": {}
}
}🟢smart_money(limit, window_min, sort, exclude_bots)
The pump.fun wallets with the best realized PnL in the last 24 h — and the tokens those wallets are buying right now. Leaderboard of wallets by realized profit on fully-closed curve positions (min 8 closed, rebuilt every 30 min), sortable by PnL, win rate or ROI, plus a live feed of what the top 50 bought in the last N minutes, ranked by how many of them piled in. When to use: To find wallets worth watching; then copy_backtest to test copying one. Price: $0.02 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "How many top wallets to return. Range 1-50. Default 20."
},
"window_min": {
"type": "integer",
"minimum": 1,
"maximum": 120,
"default": 15,
"description": "look-back for buying_now. Range 1-120. Default 15."
},
"sort": {
"type": "string",
"pattern": "^(pnl|win_rate|roi)$",
"default": "pnl",
"description": "Rank by realized PnL in SOL (\"pnl\"), win rate (\"win_rate\") or return on SOL spent (\"roi\"). Default \"pnl\"."
},
"exclude_bots": {
"type": "boolean",
"default": false,
"description": "drop sub-20-second and high-frequency wallets. Default false."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"leaderboard_built_at": {
"type": [
"string",
"null"
]
},
"window": {
"type": [
"string",
"null"
]
},
"sort": {
"type": [
"string",
"null"
]
},
"wallets": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"wallet": {
"type": [
"string",
"null"
]
},
"closed": {
"type": [
"number",
"null"
]
},
"pnl_sol": {
"type": [
"number",
"null"
]
},
"win_rate_pct": {
"type": [
"number",
"null"
]
},
"volume_sol": {
"type": [
"number",
"null"
]
},
"avg_hold_s": {
"type": [
"number",
"null"
]
},
"roi_pct": {
"type": [
"number",
"null"
]
},
"style": {
"type": [
"string",
"null"
]
}
}
}
},
"buying_now": {
"type": [
"object",
"null"
],
"properties": {
"window_min": {
"type": [
"number",
"null"
]
},
"among_top": {
"type": [
"number",
"null"
]
},
"tokens": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {}
}
}
}
},
"note": {
"type": [
"string",
"null"
]
}
}
}🟢copy_backtest(wallet, days, size_sol, exit, max_positions)
Would copying this wallet have made money? Replays its pump.fun entries and exits 0–25 slots late on the recorded curve and shows where the edge dies. Takes the wallet's pump.fun positions over the last 1–14 days and simulates a copier that buys the same token and sells when the leader sells, arriving 0, 1, 2, 5, 10 or 25 slots (0–10 s) late. Fills use the bonding-curve reserves our tape recorded at that moment, including curve fees and the copy's own price impact. Returns PnL, win rate and ROI per latency, the leader's own median ROI for contrast, and a verdict: copyable, latency-sensitive (edge gone by N slots), or not copyable. A wallet that looks great on its own PnL often loses money for anyone who follows it. When to use: After pump_wallet or smart_money, to check copying survives realistic delay. Price: $0.03 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "leader wallet to copy. Base58 Solana address, 32-44 chars."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 14,
"default": 3,
"description": "How many days of the wallet's history to replay. Range 1-14. Default 3."
},
"size_sol": {
"type": "number",
"minimum": 0.01,
"maximum": 10,
"default": 0.1,
"description": "SOL per copied entry. Range 0.01-10. Default 0.1."
},
"exit": {
"type": "string",
"pattern": "^(first_sell|full_exit)$",
"default": "first_sell",
"description": "sell on the leader's first sell, or once it has sold 90%. Default \"first_sell\"."
},
"max_positions": {
"type": "integer",
"minimum": 10,
"maximum": 300,
"default": 150,
"description": "most recent positions to replay. Range 10-300. Default 150."
}
},
"required": [
"wallet"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"wallet": {
"type": [
"string",
"null"
]
},
"label": {},
"setup": {
"type": [
"object",
"null"
],
"properties": {
"window_days": {
"type": [
"number",
"null"
]
},
"size_sol": {
"type": [
"number",
"null"
]
},
"exit_rule": {
"type": [
"string",
"null"
]
},
"positions_considered": {
"type": [
"number",
"null"
]
},
"unpriceable": {
"type": [
"number",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"fees": {
"type": [
"string",
"null"
]
}
}
},
"by_lag": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"lag_slots": {
"type": [
"number",
"null"
]
},
"approx_ms": {
"type": [
"number",
"null"
]
},
"copied": {
"type": [
"number",
"null"
]
},
"missed_after_graduation": {
"type": [
"number",
"null"
]
},
"win_rate_pct": {
"type": [
"number",
"null"
]
},
"pnl_sol": {
"type": [
"number",
"null"
]
},
"roi_pct": {
"type": [
"number",
"null"
]
},
"median_roi_pct": {
"type": [
"number",
"null"
]
},
"still_open": {
"type": [
"number",
"null"
]
},
"graduated": {
"type": [
"number",
"null"
]
}
}
}
},
"verdict": {
"type": [
"string",
"null"
]
},
"leader_median_roi_pct": {
"type": [
"number",
"null"
]
},
"fast_flips_pct": {
"type": [
"number",
"null"
]
},
"biggest_at_2_slots": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"mint": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"pnl_sol_at_2_slots": {
"type": [
"number",
"null"
]
},
"roi_pct": {
"type": [
"number",
"null"
]
},
"hold_s": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
}
}
}
},
"note": {
"type": [
"string",
"null"
]
}
}
}🟢dlmm_pool(pool)
State of a Meteora DLMM pool: price, bin step, fees, TVL, volume and fees by window (30 m–24 h), 24 h fee yield and its annualized APR/APY. For LP agents choosing where to provide liquidity. When to use: For one pool's state; for a wallet's positions use dlmm_positions. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"pool": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "DLMM pool (pair) address. Base58 Solana address, 32-44 chars."
}
},
"required": [
"pool"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"pool": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"current_price": {
"type": [
"number",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
},
"fee_yield_24h_pct": {
"type": [
"number",
"null"
]
},
"apr_pct": {
"type": [
"number",
"null"
]
},
"apy_pct_daily_compounding": {
"type": [
"number",
"null"
]
},
"yield_note": {
"type": [
"string",
"null"
]
},
"token_x": {
"type": [
"object",
"null"
],
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": [
"number",
"null"
]
},
"price": {
"type": [
"number",
"null"
]
},
"holders": {
"type": [
"number",
"null"
]
},
"is_verified": {
"type": [
"boolean",
"null"
]
}
}
},
"token_y": {
"type": [
"object",
"null"
],
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": [
"number",
"null"
]
},
"price": {
"type": [
"number",
"null"
]
},
"holders": {
"type": [
"number",
"null"
]
},
"is_verified": {
"type": [
"boolean",
"null"
]
}
}
},
"reserves": {
"type": [
"object",
"null"
],
"properties": {
"x": {
"type": [
"number",
"null"
]
},
"y": {
"type": [
"number",
"null"
]
}
}
},
"config": {
"type": [
"object",
"null"
],
"properties": {
"bin_step": {
"type": [
"number",
"null"
]
},
"base_fee_pct": {
"type": [
"number",
"null"
]
},
"max_fee_pct": {
"type": [
"number",
"null"
]
},
"protocol_fee_pct": {
"type": [
"number",
"null"
]
},
"collect_fee_mode": {
"type": [
"number",
"null"
]
}
}
},
"dynamic_fee_pct": {
"type": [
"number",
"null"
]
},
"volume": {
"type": [
"object",
"null"
],
"properties": {
"30m": {
"type": [
"number",
"null"
]
},
"1h": {
"type": [
"number",
"null"
]
},
"2h": {
"type": [
"number",
"null"
]
},
"4h": {
"type": [
"number",
"null"
]
},
"12h": {
"type": [
"number",
"null"
]
},
"24h": {
"type": [
"number",
"null"
]
}
}
},
"fees": {
"type": [
"object",
"null"
],
"properties": {
"30m": {
"type": [
"number",
"null"
]
},
"1h": {
"type": [
"number",
"null"
]
},
"2h": {
"type": [
"number",
"null"
]
},
"4h": {
"type": [
"number",
"null"
]
},
"12h": {
"type": [
"number",
"null"
]
},
"24h": {
"type": [
"number",
"null"
]
}
}
},
"fee_tvl_ratio": {
"type": [
"object",
"null"
],
"properties": {
"30m": {
"type": [
"number",
"null"
]
},
"1h": {
"type": [
"number",
"null"
]
},
"2h": {
"type": [
"number",
"null"
]
},
"4h": {
"type": [
"number",
"null"
]
},
"12h": {
"type": [
"number",
"null"
]
},
"24h": {
"type": [
"number",
"null"
]
}
}
},
"created_at": {
"type": [
"string",
"null"
]
}
}
}🟢dlmm_positions(wallet, history, page)
Open Meteora DLMM positions of any wallet: value, unclaimed fees, PnL, in/out of range — or its closed-position history. Set history=true for closed positions with deposits, withdrawals, fees and PnL per pool. When to use: For a wallet's Meteora positions; to find skilled LPs use dlmm_whales. Price: $0.005 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "wallet address. Base58 Solana address, 32-44 chars."
},
"history": {
"type": "boolean",
"default": false,
"description": "true = closed-position history instead of open positions. Default false."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 1,
"description": "Page of closed-position history (only with history=true). Range 1-50. Default 1."
}
},
"required": [
"wallet"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"wallet": {
"type": [
"string",
"null"
]
},
"mode": {
"type": [
"string",
"null"
]
},
"page": {
"type": [
"number",
"null"
]
},
"has_next": {
"type": [
"boolean",
"null"
]
},
"pools_total": {
"type": [
"number",
"null"
]
},
"positions_total": {
"type": [
"number",
"null"
]
},
"total": {
"type": [
"object",
"null"
],
"properties": {
"totalPositions": {
"type": [
"number",
"null"
]
},
"balances": {
"type": [
"string",
"null"
]
},
"balancesSol": {
"type": [
"string",
"null"
]
},
"unclaimedFees": {
"type": [
"string",
"null"
]
},
"unclaimedFeesSol": {
"type": [
"string",
"null"
]
},
"pnl": {
"type": [
"string",
"null"
]
},
"pnlSol": {
"type": [
"string",
"null"
]
},
"pnlPctChange": {
"type": [
"string",
"null"
]
},
"pnlSolPctChange": {
"type": [
"string",
"null"
]
}
}
},
"sol_price": {
"type": [
"number",
"null"
]
},
"pools": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"poolAddress": {
"type": [
"string",
"null"
]
},
"binStep": {
"type": [
"number",
"null"
]
},
"baseFee": {
"type": [
"number",
"null"
]
},
"collectFeeMode": {
"type": [
"number",
"null"
]
},
"tokenXMint": {
"type": [
"string",
"null"
]
},
"tokenYMint": {
"type": [
"string",
"null"
]
},
"tokenX": {
"type": [
"string",
"null"
]
},
"tokenY": {
"type": [
"string",
"null"
]
},
"rewardX": {
"type": [
"string",
"null"
]
},
"rewardY": {
"type": [
"string",
"null"
]
},
"balances": {
"type": [
"number",
"null"
]
},
"balancesSol": {
"type": [
"number",
"null"
]
},
"unclaimedFees": {
"type": [
"number",
"null"
]
},
"unclaimedFeesSol": {
"type": [
"number",
"null"
]
},
"feePerTvl24h": {
"type": [
"number",
"null"
]
},
"pnl": {
"type": [
"number",
"null"
]
},
"pnlSol": {
"type": [
"number",
"null"
]
},
"pnlPctChange": {
"type": [
"number",
"null"
]
},
"pnlSolPctChange": {
"type": [
"number",
"null"
]
},
"totalDeposit": {
"type": [
"number",
"null"
]
},
"totalDepositSol": {
"type": [
"number",
"null"
]
},
"openPositionCount": {
"type": [
"number",
"null"
]
},
"listPositions": {
"type": "array"
},
"updatedAt": {
"type": [
"number",
"null"
]
},
"outOfRange": {
"type": [
"boolean",
"null"
]
},
"positionsOutOfRange": {
"type": "array"
},
"poolPrice": {
"type": [
"number",
"null"
]
},
"poolStateUpdatedAtSlot": {
"type": [
"number",
"null"
]
},
"poolStateUpdatedAtBlockTime": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢dlmm_whales(limit)
Meteora DLMM liquidity providers ranked by measured on-chain edge: net USD, median multiple, win rate, hold time, size, recency. Produced by our own discovery engine, which decodes DLMM liquidity instructions across high-volume and high-yield pools every few hours and scores each wallet's completed round trips. These are the wallets our live copier watches. Price: $0.02 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "How many ranked LP wallets to return. Range 1-25. Default 10."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"generated_at": {
"type": [
"string",
"null"
]
},
"pools_scanned": {
"type": [
"number",
"null"
]
},
"method": {
"type": [
"string",
"null"
]
},
"whales": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"wallet": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"number",
"null"
]
},
"net_usd": {
"type": [
"number",
"null"
]
},
"roundtrips": {
"type": [
"number",
"null"
]
},
"win_rate_pct": {
"type": [
"number",
"null"
]
},
"median_multiple": {
"type": [
"number",
"null"
]
},
"median_hold_h": {
"type": [
"number",
"null"
]
},
"avg_trade_usd": {
"type": [
"number",
"null"
]
},
"pools_traded": {
"type": [
"number",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
}
}
}
}
}
}Community
Evidence