Skip to main content
GET
/
getUserFills
Get User Fills
curl --request GET \
  --url https://api.hypereth.io/v2/hyperliquid/getUserFills \
  --header 'X-API-KEY: <api-key>'
{
  "fills": [
    {
      "fillId": "fill_123456789",
      "orderId": "1234567890",
      "clientOrderId": "0x1234567890abcdef1234567890abcde0",
      "symbol": "BTC",
      "side": "buy",
      "price": "64950.0",
      "quantity": "0.005",
      "quoteQuantity": "324.75",
      "fee": "0.1623",
      "feeAsset": "USDT",
      "isMaker": true,
      "timestamp": 1710000001000,
      "dexProcessedTimestamp": 1710000000800,
      "tradeId": "trade_987654321",
      "hyperethTradeId": "1710000001000001"
    },
    {
      "fillId": "fill_123456790",
      "orderId": "1234567891",
      "clientOrderId": "0x1234567890abcdef1234567890abcde1",
      "symbol": "ETH/USDT",
      "side": "sell",
      "price": "3210.0",
      "quantity": "0.5",
      "quoteQuantity": "1605.0",
      "fee": "0.8025",
      "feeAsset": "USDT",
      "isMaker": false,
      "timestamp": 1710000002000,
      "dexProcessedTimestamp": 1710000001800,
      "tradeId": "trade_987654322",
      "hyperethTradeId": "1710000002000001"
    }
  ],
  "total": 2,
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  },
  "dataTime": 1710000003000,
  "dexReceivedTimestamp": 1710000000900,
  "hyperethTimestamp": 1710000001000
}

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
symbols
string

Filter to specific symbols (comma-separated, e.g., BTC/USDT,ETH/USDC). If not provided, returns fills for all symbols. Supports multiple symbols for cross-pair analysis.

​
limit
integer
default:100

Maximum number of fills to return.

Required range: x <= 1000
​
cursor
string

Pagination cursor for continuing from previous request. Each platform uses a different cursor format:

Platform-specific cursor formats:

  • Aster:
    • "id:12345" - Returns fills after this ID
    • "time:1710000000000" - Returns fills before this timestamp (endTime must be within last 7 days)
    • "time:1710000000000:1710086400000" - Returns fills within this time range (max recent 7 days range)
  • Hyperliquid: "time:1710000000000" - Returns fills before this timestamp (in milliseconds)
  • Lighter: "time:1710000000000:id:12345" - Combined time and ID format

Use the nextCursor value returned in the pagination object to fetch the next page of results.

​
accountId
string

Account identifier for multi-account support (Kuru only). If not specified, uses the default account.

Response

200 - application/json

Successful response

​
fills
object[]
​
total
integer
​
pagination
object
​
dataTime
integer<int64>
​
dexReceivedTimestamp
integer<int64>

Timestamp when HyperETH API server received this message from the venue (in milliseconds)

​
hyperethTimestamp
integer<int64>

Timestamp when HyperETH API server completed all processing before returning to client (in milliseconds)