userTwapSliceFillsByTime | Hyperliquid API Docs

Retrieve executed TWAP slice fills for a single Hyperliquid user inside a bounded time window over /info or JSON-RPC.

Use userTwapSliceFillsByTime to retrieve indexed TWAP slice fills for one user inside a bounded time window. Results are ordered by ascending fill time and include only fills with a non-zero twapId.

Endpoints

REST-style Info API:

Text

POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info

JSON-RPC:

Text

POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc

Parameters

Field	Type	Required	Description
`type`	string	yes	Must be `userTwapSliceFillsByTime` for `/info`.
`user`	string	yes	0x-prefixed Hyperliquid user address.
`startTime`	number	yes, unless `cursor` is supplied	Inclusive Unix timestamp in milliseconds. Skipped when `cursor` is supplied.
`endTime`	number	no	Exclusive Unix timestamp in milliseconds.
`cursor`	string	no	Pagination cursor in `time_txIndex` format. Resumes after that `(time, txIndex)` pair.
`limit`	number	no	Maximum rows to return, capped at 2000.

Billing

Billed by returned fill objects

userTwapSliceFillsByTime responses are billed by the number of fill objects returned, not as one response per HTTP request. A response with 100 fills counts as 100 responses/API credits.

Requests that return an empty array are billed as 0 responses/API credits and do not count against usage. Error responses are not charged.

Cursor pagination

txIndex is the fill's block-local position in the node_fills_by_block event array. It is exposed as a stable fill pagination key, not as a replica_cmds-compatible action index.

REST-style Example

Bash

curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info" \
  -H "content-type: application/json" \
  -d '{
  "type": "userTwapSliceFillsByTime",
  "user": "0x1111111111111111111111111111111111111111",
  "startTime": 1753606200000,
  "endTime": 1753606300000,
  "limit": 100
}'

JSON-RPC Example

Bash

curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc" \
  -H "content-type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "userTwapSliceFillsByTime",
  "params": {
    "user": "0x1111111111111111111111111111111111111111",
    "startTime": 1753606200000,
    "endTime": 1753606300000,
    "limit": 100
  }
}'

Response

REST /info responses return an array directly. JSON-RPC responses return the same array under result. Empty matches return []; they are not errors.

Each fill row is a normal fill object with twapId populated. For the next page, pass the last returned row's time and txIndex as cursor, for example 1753606200000_8.

userTwapSliceFillsByTime - User TWAP Slice Fills by Time