userTwapSummaries | Hyperliquid API Docs

Retrieve execution-derived TWAP summaries for a single Hyperliquid user from the Dwellir Hyperliquid Index over /info or JSON-RPC.

Use userTwapSummaries to retrieve recent execution-derived TWAP summaries for one Hyperliquid user address. Each summary aggregates indexed TWAP slice fills by (user, twapId).

Execution-derived summaries

TWAP summaries are derived from executed slice fills in the Hyperliquid Index. They summarize observed executions, not the full parent TWAP order intent or configuration.

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 `userTwapSummaries` for `/info`.
`user`	string	yes	0x-prefixed Hyperliquid user address.
`limit`	number	no	Maximum summaries to return, capped at 500.

Billing

Billed by returned summary objects

userTwapSummaries responses are billed by the number of TWAP summary objects returned, not as one response per HTTP request. A response with 50 summaries counts as 50 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.

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": "userTwapSummaries",
  "user": "0x1111111111111111111111111111111111111111",
  "limit": 50
}'

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": "userTwapSummaries",
  "params": {
    "user": "0x1111111111111111111111111111111111111111",
    "limit": 50
  }
}'

Response

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

Results are ordered newest first by lastFillTime, then txIndex, then twapId.

userTwapSummaries - User TWAP Summaries