get_big_trades

Large aggressive orders ("big trades") from the trade tape of Binance, Bybit, OKX and Hyperliquid for a symbol. Answers: "Any whale market orders on BTC in the last hour?", "Were the big prints buying or selling?", "Which venue took the largest hit?". One big trade = all fills that share venue, taker side and exchange timestamp: a market order sweeping several price levels prints as many fills at one instant, and they are summed back into one trade. aggressor: buy = the taker bought, sell = the taker sold. Per trade: t = exchange timestamp, epoch ms; venue; price = volume-weighted fill price, USD; usd = notional, whole dollars. min_usd = smallest notional that counts, at least 50000; default = the asset's threshold on the MarketTrace chart (BTC and ETH 1000000; SOL, BNB, XRP, DOGE and HYPE 500000; ZEC and ENA 100000); the response echoes the value used. totals = count (n) and summed usd of every trade at or above min_usd in the window, per side. trades = at most limit of them (1..=150, default 50): when there are more, the LARGEST are kept and truncated=true; the list is ordered by time. Window: from/to as RFC3339, YYYY-MM-DD or epoch ms; default the last hour; at most 12 h per call and from no older than 31 days, beyond either is an error, not a clamp. settled=false means the window reaches into the last 3 minutes, which the tape may not hold in full yet. coverage.venues lists the venues with tape in the window; an empty list means no tape there, not no trades (ZEC and ENA keep a 14-day tape). An order the trader split into separate child orders shows up as separate smaller trades. Descriptive: a big trade is executed flow, not a signal. Read-only.

Name	Required	Description
`to`	No	Window end (exclusive), same formats. Default: now. At most 12 h after `from`.
`from`	No	Window start: RFC3339, `YYYY-MM-DD` (UTC midnight) or epoch ms. Default: `to` minus one hour. No older than 31 days.
`limit`	No	Trades listed, 1..=150 (default 50); the largest are kept.
`symbol`	Yes	Asset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted).
`min_usd`	No	Smallest notional that counts, whole USD, at least 50000. Default: the asset's chart threshold (echoed in the response). Read as any JSON value and checked in [`big_trades_query`], so a fractional, negative or non-numeric value is an invalid_params NAMING the parameter (a typed `u64` would fail inside rmcp's deserializer with serde's "expected u64" and no field name). The schema says integer.

Name

Required

Description

Default

to

Window end (exclusive), same formats. Default: now. At most 12 h after `from`.

from

Window start: RFC3339, `YYYY-MM-DD` (UTC midnight) or epoch ms. Default: `to` minus one hour. No older than 31 days.

limit

Trades listed, 1..=150 (default 50); the largest are kept.

symbol

Yes

Asset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted).

min_usd

Smallest notional that counts, whole USD, at least 50000. Default: the asset's chart threshold (echoed in the response). Read as any JSON value and checked in [`big_trades_query`], so a fractional, negative or non-numeric value is an invalid_params NAMING the parameter (a typed `u64` would fail inside rmcp's deserializer with serde's "expected u64" and no field name). The schema says integer.

Name	Required	Description
`to`	Yes	Window end (exclusive), RFC3339 UTC.
`from`	Yes	Window start (inclusive), RFC3339 UTC.
`symbol`	Yes	Uppercase asset symbol, e.g. `BTC`.
`totals`	Yes
`trades`	Yes	At most `limit` trades — the largest by `usd` — ordered by `t`, then `venue`, then `aggressor`.
`min_usd`	Yes	Smallest notional that counts, whole USD — the value actually used.
`settled`	Yes	`false` while the window reaches into the last 3 minutes, which the tape may not hold in full yet.
`coverage`	Yes	`venues` = venues whose tape holds at least one print inside the window (empty = no tape there, not no trades).
`truncated`	Yes	`true` when the window held more big trades than `limit`.

Name

Required

Description

Default

to

Yes

Window end (exclusive), RFC3339 UTC.

from

Yes

Window start (inclusive), RFC3339 UTC.

symbol

Yes

Uppercase asset symbol, e.g. `BTC`.

totals

Yes

trades

Yes

At most `limit` trades — the largest by `usd` — ordered by `t`, then `venue`, then `aggressor`.

min_usd

Yes

Smallest notional that counts, whole USD — the value actually used.

settled

Yes

`false` while the window reaches into the last 3 minutes, which the tape may not hold in full yet.

coverage

Yes

`venues` = venues whose tape holds at least one print inside the window (empty = no tape there, not no trades).

truncated

Yes

`true` when the window held more big trades than `limit`.

MarketTrace agent-feed

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources