---
title: "Latest verified large prediction-market trades"
method: GET
path: "/api/prediction-markets/whales"
tags: ["public-pm-data"]
---

# Latest verified large prediction-market trades

`GET /api/prediction-markets/whales`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/prediction-markets/whales`
- Auth: none required

Keyless large-trade tape with source-specific evidence, provenance and
24-hour aggregates. Availability can be live, delayed or unavailable;
play-money and unverifiable activity are excluded. A large print is
information, not a recommendation.

The tape is a single cached payload of at most 50 trades. `limit`
narrows what is returned from it — useful for an embed or a
low-bandwidth client that wants 5 rows rather than 50. It cannot widen
the tape: values above 50 clamp, and a missing or malformed value
returns the full tape rather than a 400.

## Query parameters

- `limit` integer
- `minUsd` 25000 | 50000 | 100000

## Response `200`

Latest 50 accepted trades, aggregate statistics and venue coverage

- PublicPmWhalesResponse
  - `trades` PublicPmWhaleTrade[], required
    - `source` 'polymarket' | 'kalshi' | 'rothera' | 'limitless' | 'smarkets' | 'manifold' | 'metaculus' | 'predictit' | 'futuur' | 'myriad' | 'forecastex' | 'gemini', required
    - `sourceName` string
    - `sourceIcon` string, nullable
    - `eventSlug` string, required
    - `eventTitle` string
    - `wallet` string: Shortened display form of the wallet, not an identifier.
    - `walletAddress` string, nullable: Full lower-cased public address; null on venues that anonymize traders.
    - `traderName` string, nullable
    - `side` string, required
    - `outcome` string, nullable, required: Outcome label; null when the venue row carries none.
    - `marketQuestion` string, nullable: Nested market question on multi-market events; null on older rows.
    - `usdValue` number, required
    - `price` number, required
    - `sourceMarketRef` string, nullable
    - `nativeValue` number, nullable: Trade value in the venue's own currency, when it is not USD.
    - `nativeCurrency` string, nullable
    - `valueBasis` string, nullable: How `usdValue` was derived from the venue value.
    - `evidenceType` string, required
    - `evidenceRef` string, nullable
    - `evidenceUrl` string, uri, nullable
    - `availability` 'live' | 'delayed' | 'unavailable', required
    - `observedAt` string, date-time, required
    - `tradedAt` string, date-time, nullable
    - `latencySeconds` number, nullable
    - `event` object: The event this trade belongs to. Sent on `/whales` and SSE `whale` rows, not on event detail.
      - `source` string
      - `slug` string
      - `title` string
      - `image` string, nullable
      - `sourceName` string
      - `sourceIcon` string, nullable
      - `marketOutcomes` object, nullable: Outcome count and the top outcomes by probability, for a market-split display.
        - `total` integer
        - `top` object[]
          - `name` string
          - `probability` number
  - `minUsd` 25000 | 50000 | 100000: The size tier applied; present only when `minUsd` was requested.
  - `stats24h` PublicPmWhaleStats24h: Trailing 24-hour aggregates over the full verified whale table, not only the 50-row tape.
    - `count` integer, required
    - `totalUsd` number, required
    - `maxUsd` number, required
    - `bySource` object[], required
      - `source` string
      - `count` integer
      - `totalUsd` number
      - `maxUsd` number
      - `p99Usd30d` number: 99th percentile trade size over 30 days.
    - `maxTrade` object, nullable: The largest matched print. Verify `usdValue` against `maxUsd` before calling it the maximum; an unmatched print can exceed it.
  - `coverage` object[], required

## Other responses

- `429`: Public request rate limit exceeded; honor `Retry-After`.
- `500`: Server error

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)