---
title: "Notable large trades ranked against each market's own history"
method: GET
path: "/api/market/large-trades/notable"
tags: ["public-market-data"]
---

# Notable large trades ranked against each market's own history

`GET /api/market/large-trades/notable`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/market/large-trades/notable`
- Auth: none required

Keyless feed of the few large prints worth attention, judged against
each market's own trailing distribution instead of one dollar bar.
A print is notable when it clears the larger of its class floor and
its venue+symbol p99.9 over the stats window (up to 168 hours); a
market with fewer than `rules.minSymbolTrades` prints must instead
clear a multiple of the class floor and 5x its own median.
Candidates come from the last `rules.candidateHours` hours. Notable
prints of the same venue, symbol and side at most 60 seconds apart
form one burst. Newest burst first.

Hyperliquid bursts carry the largest print's `taker` (same shape as
GET /api/market/large-trades). Only `limit` is accepted; any other
query parameter returns 400. Shared-cached for about 60 seconds.

## Query parameters

- `limit` integer

## Response `200`

Notable bursts, the rules in force and source attribution

- PublicNotableLargeTradesResponse
  - `version` integer, required: Response schema version (1).
  - `generatedAt` string, date-time, required
  - `statsAsOf` string, date-time, required: When the per-market distributions were computed (recomputed at most every 10 minutes).
  - `rules` object, required: The selection rules in force.
    - `candidateHours` integer: Candidate prints come from this recent window.
    - `statsWindowHours` number: Hours of history behind the distributions (up to 168).
    - `classFloorsUsd` object: Minimum notional by class (`btcEth`, `crypto`, `commodity`, `index`, `equity`, `fx`).
    - `minSymbolTrades` integer: Prints a market needs in the window before its p99.9 is used.
    - `smallHistoryMultiple` object: Class-floor multiple for markets with less history.
    - `smallHistoryP50Multiple` number
    - `burstGapSeconds` integer
  - `candidatesTruncated` boolean, required: True when the candidate row cap was reached.
  - `totalNotable` integer, required: Notable bursts before `limit`.
  - `count` integer, required
  - `items` PublicNotableLargeTrade[], required: Newest burst first.
    - `id` string, required: The largest print's row id (`venue:symbol:tradeId`).
    - `venue` string, required
    - `symbol` string, required
    - `base` string, required
    - `assetClass` string, required
    - `side` string, required: Taker side: `buy` or `sell`.
    - `notionalUsd` number, required: Summed over the burst.
    - `qty` number, required
    - `avgPrice` number, required
    - `fills` integer, required
    - `trades` integer, required: Prints in the burst.
    - `firstTime` string, date-time, required
    - `lastTime` string, date-time, required
    - `largestTrade` object, required
      - `tradeId` string, required
      - `notionalUsd` number, required
      - `price` number, required
      - `qty` number, required
      - `tradeTime` string, date-time, required
    - `buyer` string, nullable, required
    - `seller` string, nullable, required
    - `sourceRef` string, nullable, required: Venue reference of the largest print (Hyperliquid transaction hash).
    - `links` PublicLargeTradeLinks, required
      - `market` string, uri, required: The venue's market page.
      - `buyer` string, nullable, required: Explorer page of the buyer address (Hyperliquid only).
      - `seller` string, nullable, required: Explorer page of the seller address (Hyperliquid only).
      - `tx` string, nullable, required: Explorer page of the transaction (Hyperliquid only).
    - `significance` PublicNotableLargeTradeSignificance, required: The largest print against its own market's distribution.
      - `windowHours` number, required
      - `symbolTrades` integer, required: Prints of this venue and symbol in the window.
      - `p50Usd` number, nullable, required
      - `p99Usd` number, nullable, required
      - `p999Usd` number, nullable, required
      - `maxUsd` number, nullable, required
      - `multipleOfP999` number, nullable, required
      - `isLargestInWindow` boolean, nullable, required: Null only for a market newer than the cached distributions.
      - `rankInWindow` integer, nullable, required: 1 + prints strictly larger in the window; null when not exact.
      - `thresholdUsd` number, required: The bar this print cleared.
      - `basis` string, required: `p999` (the market's p99.9 or its class floor) or `smallHistory` (class-floor multiple and median multiple while history is short).
    - `taker` PublicLargeTradeTaker: The taker side of a Hyperliquid print, matched from the taker wallet's own fills. `positionNow` is the wallet's position in that market when the row was enriched, which can be after the print.
      - `address` string, required: Taker wallet, lower-case 0x address.
      - `action` string, required: What the print did to the taker's position: `open`, `add`, `reduce`, `close` or `flip` (crossed from long to short or back). Treat other values as unknown.
      - `dir` string, nullable, required: Hyperliquid's own direction text for the fills, e.g. `Open Long`, `Close Short`, or a joined value such as `Close Short / Short > Long / Open Long` when one transaction did several things.
      - `filledQty` number, nullable, required: Size the taker filled, in base units.
      - `realizedPnlUsd` number, nullable, required: Realized PnL of the taker's fills in USD on a reduce, close or flip; null on open and add.
      - `feeUsd` number, nullable, required: Fees the taker paid on these fills, USD.
      - `positionNow` PublicLargeTradeTakerPosition, required
        - `size` number, nullable, required: Signed position size in base units (negative is short); 0 when flat.
        - `avgEntryPrice` number, nullable, required
        - `leverage` number, nullable, required
        - `liquidationPrice` number, nullable, required
        - `unrealizedPnlUsd` number, nullable, required
        - `asOf` string, date-time, required: When the position was read.
  - `source` PublicMarketFeedSource, required
    - `provider` string, required
    - `venues` PublicMarketFeedVenue[], required
      - `venue` string, required
      - `name` string, required
      - `url` string, uri, required
      - `feed` string, required: The venue's public feed the collector reads.
      - `note` string: Venue-specific coverage limitation, when published.
    - `method` string, required: How rows are selected and valued.
    - `coverage` string: Which markets are collected, and the gap caveat.

## Other responses

- `400`: Invalid or unknown query parameter
- `429`: Public request rate limit exceeded; honor `Retry-After`.
- `500`: Notable large trades temporarily unavailable

---

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