Recipe 57 of 65
What are the latest large trades on a Hyperliquid coin, including HIP-3 and spot?
/v1/hl-cohorts/symbols/{symbol}/large-fills returns a coin's newest fills of $50,000 or more with wallet, side, price, market or limit, and cohort labels; smaller trades are only in the daily fills file of the archive.
GET /v1/hl-cohorts/symbols/{symbol}/large-fills answers it in one call, as the live tape of big trades: one coin's newest fills of at least
$50,000 in the last 24 hours, newest first, each with the wallet, direction, size, price, order_type and the
wallet's cohort labels. It works for core perps (BTC), HIP-3 perps (xyz:PLATINUM) and spot indexes (@107).
Every trade, of any size, is live only as price and size, without wallets; see the variations and the caveat. The
full parameter list is on Large fills.
Quick answer
Put the coin in the path; $50,000 is the floor.
# the newest BTC fills of $50,000 or more
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hl-cohorts/symbols/BTC/large-fills?limit=3"Example response
Captured from the live API on 2026-10-24 at 17:16 UTC, all three rows limit=3 asked for.
The first two rows match as the two sides of one trade: a market buy of 1.0969 BTC by one wallet and a resting limit
sell of the same size, at the same price and millisecond. truncated: true with covered_from 16:57:08 means the feed reached back only 20 minutes on BTC at
capture time; has_more says limit=3 cut further rows.
{
"symbol": "BTC",
"min_usd": 50000.0,
"hours": 24,
"covered_from": "2026-10-24T16:57:08.149000+00:00",
"truncated": true,
"has_more": true,
"size_cohort_basis": "current",
"fills": [
{
"ts": "2026-10-24T17:15:21.287000+00:00",
"wallet": "0x67d4efe87d546d1351952263aed60921cffc8eee",
"direction": "buy",
"size_token": 1.0969,
"size_usd": 87879.2404,
"price": 80116.0,
"order_type": "market",
"size_cohort": "shark",
"pnl_cohort": "3x smart",
"pnl_cohort_basis": "current"
},
{
"ts": "2026-10-24T17:15:21.287000+00:00",
"wallet": "0x706bb519b05b7dc01d048af9a5e29d1ef5d6d9e3",
"direction": "sell",
"size_token": 1.0969,
"size_usd": 87879.2404,
"price": 80116.0,
"order_type": "limit",
"size_cohort": "2x fish",
"pnl_cohort": "3x smart",
"pnl_cohort_basis": "current"
},
{
"ts": "2026-10-24T17:15:21.287000+00:00",
"wallet": "0x588432f54227364caf999a6df88dbf86a90f4772",
"direction": "sell",
"size_token": 1.27456,
"size_usd": 102112.64895999999,
"price": 80116.0,
"order_type": "limit",
"size_cohort": "dolphin",
"pnl_cohort": "3x smart",
"pnl_cohort_basis": "current"
}
]
}Variations
A spot pair. Spot is addressed by its index; HYPE spot is @107.
# the newest HYPE spot fills of $50,000 or more
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hl-cohorts/symbols/@107/large-fills?limit=3"On the same capture HYPE spot was not truncated: covered_from was the full 24-hour window start, and the newest row
was a $51,960 market buy at 75.511.
A HIP-3 market, bigger trades only. Raise min_usd and shorten hours.
# XYZ platinum fills of $100,000 or more in the last 6 hours
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hl-cohorts/symbols/xyz:PLATINUM/large-fills?min_usd=100000&hours=6"Every trade's price and size, without wallets. Bars of one trade (interval=1t) list each trade up to now, from the taker side, with no wallet and no side. Pin a short
window: with no start the window is the 24 hours before end and limit keeps the oldest bars.
# every BTC trade in a pinned three-second window
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/ohlcv?symbol=BTC&interval=1t&start=2026-10-21T00:00:00Z&end=2026-10-21T00:00:03Z&limit=10"Captured from the live API on 2026-10-24 at 17:37 UTC, it returned 7 bars, one per trade, each with n_trades 1. Their ts is cut to the
whole second (1792540802000 for six of them) and trades within one second came back out of time order, so use them for
price and size, not for sequence.
Every trade, a day later. Trades under $50,000 are in the archive's daily fills file: every fill of every wallet, one file per UTC day, published the following early UTC morning.
# a temporary download link for one day of every fill
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/archive/url?dataset=fills&date=2026-10-23"Before you rely on it
Only $50,000 and up, and only the newest 200 per coin
The live answer covers fills of $50,000 or more; a lower min_usd is refused. The feed keeps the newest 200 such fills
per coin over 24 hours, so on a busy coin it reaches back minutes, not a day: covered_from says how far and
truncated says the cap may have cut older ones. Smaller trades come live only as 1-trade bars, without wallet or side;
with their wallets they are in the next day's archive file.
Each trade appears twice
Both sides of a trade are rows: the buyer and the seller, same ts, size and price. order_type: market marks the
side that crossed the book. Count trades from one side, or sum only market rows, or you count notional twice.
Liquidations are not flagged.
Ask your agent
Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words.
The hl_market tool answers with view: large_fills, at 1 credit a call.
Show the latest BTC trades over $100,000 on Hyperliquid with each wallet's cohort