Get pump and dump data
GET /v1/pump-dump/data
Returns coins ranked by their composite pump-and-dump divergence score, descending.
Query parameters
One coin by its CoinGecko id (e.g.
pepe): its row exactly as the scorer wrote it, whatever its score. A coin that stopped qualifying answers score: null with its sub-scores and phase cleared; an id with no row answers an empty list. limit, min_score and phase do not apply.Response fields
Composite manipulation risk score from
0 to 10. Higher means stronger alignment across derivatives, market structure, holder, liquidity, and flow signals. If funding, price or derivatives inputs are missing, the score is a conservative lower bound rather than a measured neutral reading; missing on-chain inputs are left out and the remaining weights re-normalize, so that gap can move the score either way. null only on a coin request for a coin that stopped qualifying.Weighted input completeness from
0 to 1 across funding, price, derivatives, and on-chain groups (0.81 is 81%).full when every signal group is observed, partial at a signal_coverage of 0.5 or more, otherwise limited. Compare scores only with their coverage in view.lower-bound-partial-inputs when a funding, price or derivatives input is missing (it scores as zero), otherwise fully-observed. A row missing only on-chain inputs reads fully-observed: those are left out and the weights re-normalize, and the gap shows in incomplete_signal_groups.Sub-score
[0, 1] reflecting the absolute size of negative funding (1.0 = -0.05%/8h or stronger).Sub-score
[0, 1] reflecting the size of the 7-day price move on a log scale (100% pump ≈ 0.67, saturates at large pumps).Sub-score
[0, 1] summarizing funding, OI, basis, CVD, liquidation, and cross-venue positioning pressure. Basis and CVD exist only for the futures-covered majors; on other coins they are null and add nothing, so the sub-score is a lower bound.Sub-score
[0, 1] summarizing top-10 holder share and holder-count scarcity. null when no on-chain holder data is available.Sub-score
[0, 1] summarizing holder concentration, liquidity fragility, flow imbalance, and contract/security context. null when none of those inputs is observed.Deprecated. Alias of
pump_magnitude. Will be removed after a deprecation window. New consumers should use pump_magnitude directly.Trailing 7d price return as a fraction. Used as market context alongside holder, liquidity, flow, and derivatives signals.
Share of supply held by the top 10 holders, from
0 to 1. null when unknown, including when contracts (treasury Safes, vesting, bridges, pools) hold over half of the top-10 share. Exchange hot wallets still count as holders.24h open-interest change as a decimal, when futures data is available, over the contracts with a reading 24-28 hours before their latest (MEXC excluded): computed as
/v1/global/overview computes oiChange24h.Net taker flow over each venue’s newest 24 hourly candles with exchange-reported taker-buy volume (at least 15, the newest at most 3 hours old), averaged over venues, as a decimal in [-1, 1]; null when no venue qualifies. Price prediction scores the same figure as CVD.
Average perp basis as a decimal, when spot/index and futures price context is available.
Change in
top10_holders_share since the previous successful scoring run: the difference of the two shares (0.012 is a share up from 0.300 to 0.312), not a relative change.Latest
updated_at timestamp represented by the returned rows, in ISO 8601 format. null when no valid score timestamp is available.Methodology metadata:
methodology, gate, update_frequency, and the list of exchanges monitored.Response
X-Sharpe-Data-State is ok or stale using the same 1-hour SLA. Stale rows remain available with HTTP 200, but clients should treat them as historical context rather than a current trading signal. A database or query failure answers 503 (service_unavailable, Retry-After: 30) in the normal API error envelope.
How the score is built
The score is a composite risk model capped at 10. It uses multiple signal families:- Derivatives pressure: funding, open interest, basis, true taker-flow/CVD, and liquidation context.
- Holder concentration: top-10 holder share and holder-count context.
- Liquidity and flow quality: liquidity depth, volume-to-liquidity churn, and buy/sell imbalance.
- Phase detection: setup, markup, distribution, and dump-risk behavior.
signal_coverage, signal_coverage_status, and incomplete_signal_groups alongside score.
See the insider selling signal
