Prediction.com APIdocs

Pricing Your keys

Fade Finder Alerts

A newest-first feed of contrarian signals based on large-wallet positioning.

GET/v2/alerts/fade-finder

Plans Dev and upPlan rate limits apply

Historical signals are not live executable quotes or guarantees of future returns. Requests count toward your plan's fade-finder endpoint-group quota.

Parameters

alert_typestring

Accepted values: all, fade. Default: all. Response alert_type values use the whale_ prefix.

limitinteger

Alerts per page. Default: 20; minimum: 1; maximum: 100.

cursorstring

Opaque next_cursor from the previous response. Keep the same filters; stop when has_more is false.

sincestring

Include alerts created at or after this ISO 8601 timestamp. Use a timezone, for example 2026-09-01T00:00:00Z.

platformstring

Filter by the signal's platform_buy value, for example polymarket or kalshi.

Response

alertsobject[]

Signals ordered by created_at descending, then id descending.

Show 11 fields

idinteger

Unique alert ID. Use it to deduplicate alerts.

alert_typestring

Stored signal type: whale_smart_money, whale_insider, whale_captain_hook, or whale_fade.

titlestring

Signal title.

descriptionstring | null

Signal summary.

created_atstring | null

Alert creation timestamp in ISO 8601 format.

event_idinteger | null

Prediction.com event ID when linked.

group_idinteger | null

Prediction.com match group ID when linked.

event_urlstring | null

Event page URL when available.

market_slugstring | null

Market slug when available.

platform_buystring | null

Platform associated with the signal.

dataobject | null

Signal-specific details. Fields vary by alert type and may be absent in older alerts.

next_cursorstring | null

Opaque cursor for the next page. Keep the same filters when continuing.

has_moreboolean

Whether another page is available.

Try it

Sample data

Alert type

Limit

Cursor

Since

Platform

Sample mode returns a fixed recorded example; input changes apply to live requests. Switch it off to query live data with these parameters.

{
  "alerts": [
    {
      "alert_type": "whale_fade",
      "created_at": "2026-09-23T00:51:41.702404+00:00",
      "data": {
        "game_start_time": null,
        "game_status": null,
        "losing_wallet": {
          "amount": 9.54,
          "outcome": "no",
          "outcome_raw": "no",
          "pnl_to_date": -338136.25,
          "price": 0.06,
          "side": "BUY",
          "userAddr": "0xE91171f655bE1568e4c63f29663c0028649e3d4e"
        },
        "marketSlug": "col1-inm-jdc-2026-09-18-inm",
        "profitable_wallet": {
          "amount": 240.7566,
          "outcome": "yes",
          "outcome_raw": "yes",
          "pnl_to_date": 205545.89,
          "price": 0.98,
          "side": "BUY",
          "userAddr": "0xE337F5A28E9C530a676C959A1888Ba5368664ad6"
        },
        "profitable_wallet_count": 3,
        "resolution_date": "2026-09-18",
        "time_delta_min": 8.666666666666666,
        "top_profitable_wallets": [
          {
            "amount": 240.7566,
            "pnl_to_date": 205545.89,
            "price": 0.98,
            "userAddr": "0xe337f5a28e9c530a676c959a1888ba5368664ad6"
          },
          {
            "amount": 149.46,
            "pnl_to_date": 40285.457,
            "price": 0.94,
            "userAddr": "0x4bc5d791b6426215ad2bf26ff209af054e1ee563"
          },
          {
            "amount": 116.85,
            "pnl_to_date": 1611403.1,
            "price": 0.95,
            "userAddr": "0x821dab0565ebf5b327f51db06223fdcfe01acf16"
          }
        ],
        "unmatched_slug": true
      },
      "description": "Profitable wallet ($205.5K) bets yes while losing wallet ($-338.1K) bets no",
      "event_id": null,
      "event_url": "https://polymarket.com/market/col1-inm-jdc-2026-09-18-inm?r=predictionhunt",
      "group_id": null,
      "id": 2046413,
      "market_slug": "col1-inm-jdc-2026-09-18-inm",
      "platform_buy": "polymarket",
      "title": "Will Independiente Medellín win on 2026-09-18?"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJkIjoiMjAyNi0wOS0yM1QwMDo1MTo0MS43MDI0MDQrMDA6MDAiLCJpZCI6MjA0NjQxM30="
}