Wallet orders

What became of one wallet's orders in a window: each order that rested in it or was filled in it, with the fills it received and a status.

GET https://data.vike.io/v1/hyperliquid/wallets/{address}/orders

What became of one wallet's orders in a window: each order that rested in it or was filled in it, with the fills it received in the window and a status. Newest placement first. Use it for the history of one wallet; to see what is resting on a market, use /orders.

cURL

# what became of one wallet's orders over the default window, the last 7 days
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/orders?limit=3" \
  -H "X-API-KEY: $VIKE_API_KEY"

# only the orders that filled, on one symbol
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/orders?symbol=BTC&status=filled&limit=2" \
  -H "X-API-KEY: $VIKE_API_KEY"

# orders that were hit for part of their size and then left the book
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/orders?status=partially_filled&limit=2" \
  -H "X-API-KEY: $VIKE_API_KEY"

# a bounded window: the ETH orders of 25 October
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/orders?symbol=ETH&from=2026-10-25T00:00:00Z&to=2026-10-26T00:00:00Z&limit=3" \
  -H "X-API-KEY: $VIKE_API_KEY"

addresspathrequired

The wallet

fromqueryoptional

ISO-8601 UTC. Default: 7 days before to

toqueryoptional

ISO-8601 UTC. Default: the newest order snapshot. At most 30 days after from

symbolqueryoptional

HL perp ticker

statusqueryoptional

open | filled | partially_filled | canceled_or_expired

limitqueryoptional

Default 100, max 1000

cursorqueryoptional

nextCursor from the previous page, verbatim

Captured from the live API on 2026-10-27 at 10:58 UTC for the first call. Two of the three orders returned are shown.

Example response

{
  "wallet": "0xbf49ffdc3008791900bb96ebccb61118f70c1bc9",
  "from": "2026-10-20T10:55:00+00:00",
  "to": "2026-10-27T10:55:00+00:00",
  "snapshotTs": "2026-10-27T10:55:00+00:00",
  "source": "l4_5m",
  "orders": [
    {
      "oid": 585454617067,
      "symbol": "BTC",
      "side": "sell",
      "status": "filled",
      "seenInSnapshots": true,
      "orderType": "Stop Market",
      "limitPx": 72270.0,
      "triggerPx": 80300.0,
      "isPositionTpsl": true,
      "reduceOnly": true,
      "tif": null,
      "cloid": null,
      "origSz": null,
      "placedAt": "2026-10-25T17:45:07.165000+00:00",
      "firstSeen": "2026-10-25T17:50:00+00:00",
      "lastSeen": "2026-10-25T21:45:00+00:00",
      "builder": null,
      "builderFeeTenthsBp": null,
      "nFills": 1,
      "filledSz": 0.00496,
      "avgFillPx": 80295.0,
      "makerShare": 0.0,
      "firstFillAt": "2026-10-25T21:45:37.391000+00:00",
      "lastFillAt": "2026-10-25T21:45:37.391000+00:00",
      "closedPnl": -1.012832,
      "fillFees": 0.172049,
      "feeToken": "USDC"
    },
    {
      "oid": 585454478894,
      "symbol": "SOL",
      "side": "sell",
      "status": "filled",
      "seenInSnapshots": true,
      "orderType": "Stop Market",
      "limitPx": 90.9,
      "triggerPx": 101.0,
      "isPositionTpsl": true,
      "reduceOnly": true,
      "tif": null,
      "cloid": null,
      "origSz": null,
      "placedAt": "2026-10-25T17:44:49.011000+00:00",
      "firstSeen": "2026-10-25T17:45:00+00:00",
      "lastSeen": "2026-10-25T21:55:00+00:00",
      "builder": null,
      "builderFeeTenthsBp": null,
      "nFills": 1,
      "filledSz": 3.94,
      "avgFillPx": 100.94,
      "makerShare": 0.0,
      "firstFillAt": "2026-10-25T21:58:10.314000+00:00",
      "lastFillAt": "2026-10-25T21:58:10.314000+00:00",
      "closedPnl": -0.980666,
      "fillFees": 0.171807,
      "feeToken": "USDC"
    }
  ],
  "notes": [
    "canceled_or_expired: the order left the book with no fill in the window. A manual cancel, a margin cancel, a reduce-only cancel and an expiry look the same in the snapshots, so they are not told apart.",
    "Fill figures count only fills inside the window: an order filled partly before `from` and canceled in the window reads as canceled_or_expired, and one filled before `from` as partially_filled.",
    "seenInSnapshots=false: placed and filled between two snapshots, never seen resting, so its original size, limit price and placement time are unknown; it is reported as filled.",
    "open: present in the newest snapshot (snapshotTs). Snapshots are 5 minutes apart (l4_5m) or ~12 minutes (state_12m), so an order can have filled or been canceled since."
  ],
  "nextCursor": "eyJMIjoiMjAyNi0xMC0yNyAxMDo1NTowMCIsImYiOiIyMDI2LTEwLTIwIDEwOjU1OjAwIiwiayI6IjB4YmY0OWZmZGMzMDA4NzkxOTAwYmI5NmViY2NiNjExMThmNzBjMWJjOXx8fHwiLCJsNCI6MSwibSI6IndhbGxldF9vcmRlcnMiLCJvIjo1ODU0NTQzODM1ODAsInMiOiJsNF81bSIsInRvIjoiMjAyNi0xMC0yNyAxMDo1NTowMCIsInRzIjoiMjAyNi0xMC0yNSAxNzo0NDozNi43OTAifQ"
}

The window. to defaults to the newest snapshot (snapshotTs) and from to 7 days before to. A window longer than 30 days is a 400 that names the window you sent; read a longer span in slices with from and to. limit takes 1 to 1000 and defaults to 100; 0 or a negative value also reads as 100, and a value above 1000 is refused with a 422. nextCursor pins the window and the query: a cursor sent with a different from, to, symbol or status, or for another wallet, is a 400, while limit may change between pages. A call costs 1 credit (Rate limits).

Status is one of four, filterable with status:

open: the order is in the newest snapshot and its fills do not yet cover its size. It wins over partially_filled, so a resting order that has been hit for part of its size is open with a filledSz greater than 0.
filled: the fills in the window add up to the order's size, or the order was never seen resting (seenInSnapshots is false). A whole-position stop or take-profit that fired is also filled.
partially_filled: some fills in the window, and the order has left the book.
canceled_or_expired: the order left the book with no fill in the window.

The fill figures (nFills, filledSz, avgFillPx, makerShare, firstFillAt, lastFillAt, closedPnl, fillFees, feeToken) sum the fills the order received inside the window. makerShare is the maker share of the filled notional. An order with no fills reads 0 for nFills, filledSz, closedPnl and fillFees and null for the rest. Every response carries notes, which repeat the limits of what a snapshot can tell.

Orders that ended before 2026-07-29 appear only through their fills, as seenInSnapshots: false rows: order history starts with the first checkpoint on that day. An order still resting then is listed with its true placedAt.

A cancel, a margin cancel and an expiry are one status

canceled_or_expired means the order left the book with no fill in the window. A manual cancel, a margin cancel, a reduce-only cancel and an expiry look the same in the snapshots, so they are not told apart.

seenInSnapshots false: the placement fields are null

An order that was never seen resting in a snapshot appears only through its fills, so its type, limit and trigger price, size, tif, reduceOnly, cloid, builder and placement and sighting times are null. It is reported as filled whatever share of it filled: it may have been placed and filled between two snapshots, or filled in part and canceled at once, as an immediate-or-cancel order is. Only its symbol, side and fill figures are known, and it sorts by its first fill.

Fill figures count only fills inside the window

A fill before from is not counted, so an order that filled partly before the window and was canceled inside it reads as canceled_or_expired. Widen from (up to 30 days before to) to see more of its fills.

open is as of the newest snapshot

Snapshots are 5 minutes apart (the checkpoints about 12), so an order shown open can have filled or been canceled since snapshotTs.

Fields are camelCase here and on /orders

This route and /orders use camelCase field names; /symbols/{symbol}/order-clusters uses snake_case.