Skip to content

Pump and Dump Detection

Pump & Dump exposes a composite 0-10 score per coin built from price/funding divergence: rising spot prices while perpetual funding rates stay aggressively negative across 13 exchanges. The pattern often signals retail-driven price spikes that derivatives traders are systematically fading.

The signal is gated — a coin only qualifies when both the trailing 72h average funding is negative AND the trailing 7d price change is positive. This filters out plain bear-market drawdowns and focuses the list on genuine divergences.

The score updates every 30 minutes.


GET/v1/pump-dump/data

Get pump and dump data

Returns coins ranked by their composite pump-and-dump divergence score, descending.

Query parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of coins to return. 1 to 500. Default 100.

  • Name
    min_score
    Type
    number
    Description

    Filter to coins scoring at or above this threshold. 0 to 10. Default 0.

Response fields

  • Name
    coins
    Type
    array
    Description

    Array of scored coins, sorted by score descending.

  • Name
    coins[].coin_id
    Type
    string
    Description

    CoinGecko-style slug.

  • Name
    coins[].symbol
    Type
    string
    Description

    Ticker symbol.

  • Name
    coins[].name
    Type
    string
    Description

    Display name.

  • Name
    coins[].score
    Type
    number
    Description

    Composite divergence score from 0 to 10. Higher means stronger divergence between rising price and aggressive shorting.

  • Name
    coins[].avg_funding_72h
    Type
    number
    Description

    Average funding rate across exchanges over the trailing 72 hours, expressed as a decimal.

  • Name
    coins[].funding_magnitude
    Type
    number
    Description

    Sub-score [0, 1] reflecting the absolute size of negative funding (1.0 = -0.05%/8h or stronger).

  • Name
    coins[].pump_magnitude
    Type
    number
    Description

    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).

  • Name
    coins[].divergence_persistence
    Type
    number
    Description

    Sub-score [0, 1] reflecting consecutive days funding has stayed negative (1.0 = 7 or more days). Boosts sustained patterns toward the maximum score.

  • Name
    coins[].price_funding_divergence
    Type
    number
    Description

    Deprecated. Alias of pump_magnitude. Will be removed after a deprecation window. New consumers should use pump_magnitude directly.

  • Name
    coins[].consecutive_negative_days
    Type
    integer
    Description

    Number of consecutive trading days with negative average funding.

  • Name
    coins[].price_change_24h
    Type
    number
    Description

    Trailing 24h price change as a percentage.

  • Name
    coins[].price_change_7d
    Type
    number
    Description

    Trailing 7d price change as a percentage. Required to be positive for the coin to appear.

  • Name
    coins[].signal_start_date
    Type
    string
    Description

    ISO 8601 timestamp of when the divergence began.

  • Name
    coins[].updated_at
    Type
    string
    Description

    ISO 8601 timestamp of the most recent score recomputation.

  • Name
    count
    Type
    integer
    Description

    Number of rows in coins.

  • Name
    description
    Type
    string
    Description

    Plain-language summary of the signal for client display.

  • Name
    signal
    Type
    object
    Description

    Methodology metadata: methodology, gate, update_frequency, and the list of exchanges monitored.

Request

GET
/v1/pump-dump/data
curl -G https://www.sharpe.ai/api/v1/pump-dump/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d limit=20 \
  -d min_score=4

Response

{
  "data": {
    "coins": [
      {
        "coin_id": "example-token",
        "symbol": "EXMP",
        "name": "Example Token",
        "score": 7.6,
        "avg_funding_72h": -0.00021,
        "funding_magnitude": 0.74,
        "pump_magnitude": 0.78,
        "divergence_persistence": 0.71,
        "price_funding_divergence": 0.78,
        "consecutive_negative_days": 5,
        "price_change_24h": 4.81,
        "price_change_7d": 18.2,
        "signal_start_date": "2026-04-21T00:00:00Z",
        "updated_at": "2026-04-26T07:00:00Z"
      }
    ],
    "count": 1,
    "description": "Pump and dump detection scores based on price/funding rate divergence across 13 perpetual futures exchanges.",
    "signal": {
      "methodology": "Composite score (0-10) based on funding rate magnitude and price/funding divergence. Higher scores indicate stronger divergence between rising price and aggressive short positioning.",
      "gate": "Requires both negative 72h average funding rate AND positive 7d price change.",
      "update_frequency": "every 30 minutes",
      "exchanges": [
        "Binance", "Bybit", "OKX", "Gate.io", "Bitget", "Hyperliquid",
        "Deribit", "BitMEX", "HTX", "BingX", "CoinEx", "KuCoin", "MEXC"
      ]
    }
  },
  "meta": {
    "request_id": "req_pumpdump_xyz789",
    "timestamp": "2026-04-26T07:00:05Z"
  }
}

How the score is built

The score is a multiplicative composite of three sub-scores, capped at 10:

  • Funding magnitude [0, 1] — how negative the trailing 72h average funding rate is. Saturates at −0.05%/8h (≈ −54.75% APR).
  • Pump magnitude [0, 1] — the 7-day price move, log-scaled so 100% scores ~0.67 and 1000%+ saturates. (Previously named price_funding_divergence; the rename reflects what the formula actually measures.)
  • Divergence persistence [0, 1] — consecutive days funding has stayed negative, saturating at 7 days. Pump-and-dumps are short-term events; sustained week-plus patterns score the strongest.

Composite formula:

score = funding_magnitude × pump_magnitude × (0.6 + 0.4 × divergence_persistence) × 10

The multiplicative core captures the divergence: only the combination of negative funding AND rising price scores. Funding alone is just bearish flow; a pump alone is just retail momentum. The persistence factor is a [0.6, 1.0] boost — fresh signals still surface (capped at ~6/10 with no persistence yet), but a 7-day-persistent equivalent can hit the maximum.

The gate is strict: a coin must have both a negative 72h average funding and a positive 7d price change to be considered. That keeps the list focused on suspicious divergences instead of routine selloffs.

Was this page helpful?