Unified REST APITrading

Get User Fills

Get user's trade fills/executions history.

Multi-account support: Use accountId to query a specific account's fills. If not specified, defaults to the primary account.

GET
/getUserFills

Authorization

ApiKeyAuth
X-API-KEY<token>

In: header

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?integerdefault: 100

Maximum number of fills to return.

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. If not specified, uses the default account.

marketType?enum<string>

Optional market type filter. Use "spot" for spot markets or "perp" for perpetual/futures markets.

Available options: spotperp

Response Body

application/json

curl -X GET "https://api.hypereth.io/v2/hyperliquid/getUserFills?symbols=BTC%2CETH&accountId=acc_A"
{
  "fills": [
    {
      "fillId": "fill_123456789",
      "orderId": "1234567890",
      "clientOrderId": "0x1234567890abcdef1234567890abcde0",
      "symbol": "BTC",
      "marketType": "future",
      "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",
      "marketType": "future",
      "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
}

Get Open Orders GET

Get all open/unfilled orders for the user. **Multi-account support**: Use `accountId` to query a specific account's orders. If not specified, defaults to the primary account.

Subscription WSS

Channel for sending subscription and unsubscription requests (available on hyperliquid, aster, lighter, kuru, hyena, grvt, and nado servers). Note - position, user_funding_fee, and liquidation_trades are not available on kuru (spot DEX).