Replay historical large trades
get_large_trades_historyReplay historical large trades from the local record. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort.
Args:
limit (number, 1-100, default 20)
cursor (string, optional): Pagination cursor with wth_ prefix
min_size (number, optional): Minimum trade size in USD
condition_id (string, optional): Exact raw provider condition_id
event_slug (string, optional): Every market of one game, the markets get_game_trades reads; recent order only, not with condition_id; an unknown slug is not_found
trader (string, optional): Wallet, alias, or username
category (string, optional): Filter by market category (case-insensitive): a sport such as Basketball, a league such as NBA (it folds into its sport), Esports, or sports for every sport but Esports. Omit it for every sports and esports trade
min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time; not with min_grade_at_trade
min_grade_at_trade (string, optional): Minimum grade the trader held when the trade filled (graded only), the basis the stream and webhooks share; not with min_grade
suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60
platform (string, optional): polymarket or all
from/to (string, optional): RFC3339 traded_at bounds
min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
Returns: Historical large trades with replay metadata, current review_score (signal_score is its deprecated twin, same value, until its 2027-02-01 sunset) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin until its 2027-02-01 sunset; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. Each trade carries clv, its closing line value against the market's stored close (get_market_close): status measured, in_play, pending or unavailable, and when measured clv_cents, positive when the trade beat the close (buy: close minus price; sell: price minus close; cents per share, gross of fees). taker_fee_cents is the fee the fill paid as taker, cents per share, from the exchange's on-chain record of the fill (null until that record is decoded, about a minute after the trade, and before 2026-08-16); clv_after_fees_cents is clv_cents minus it, set when both are. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh and stale both mean tracked and clocked; stale means as_of is older than max_age_s, the refresh budget of the group writer. Neither is a tolerance: compare as_of with your own. unknown means this read cannot date that group, never that it is recent.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_large_trades_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Exclusive traded_at upper bound | |
| from | No | Inclusive traded_at lower bound | |
| sort | No | Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over from, or the last 30 days when from is omitted. A cursor is bound to the order it was minted in | recent |
| limit | No | Max results (1-100, default 20) | |
| cursor | No | Pagination cursor from previous response | |
| trader | No | Trader wallet, alias, or username | |
| category | No | Filter by market category (case-insensitive): a sport such as Basketball, a league such as NBA (it folds into its sport), Esports, or sports for every sport but Esports. Omit it for every sports and esports trade | |
| min_size | No | Minimum trade size in USD | |
| platform | No | Filter by provider platform | |
| min_grade | No | Minimum trader grade now; not with min_grade_at_trade | |
| event_slug | No | Every market of one game (moneyline, spreads, totals and props), the markets get_game_trades reads; for example nba-bos-orl-2026-11-01. An unknown slug is not_found. Recent order only; not with condition_id or since | |
| condition_id | No | Exact raw provider condition_id | |
| suspicious_only | No | Keep only rows with persisted suspicion_score >= 60 | |
| min_grade_at_trade | No | Minimum grade the trader held when the trade filled (grade_at_trade, graded only), the basis the stream and webhooks share; not with min_grade | |
| min_market_volume_share | No | Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||