Skip to main content
POST
/
api
/
v1
/
developer
/
trading
/
hyperliquid
/
info
/
order
/
history
Get order history
curl --request POST \
  --url https://api.allium.so/api/v1/developer/trading/hyperliquid/info/order/history \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "type": "historicalOrders",
  "user": "0x1234567890abcdef1234567890abcdef12345678",
  "startTime": 1640995200000,
  "endTime": 1641081600000
}
'
[
  {
    "order": {
      "coin": "<string>",
      "side": "<string>",
      "limitPx": "<string>",
      "sz": "<string>",
      "oid": 123,
      "timestamp": 123,
      "triggerCondition": "<string>",
      "isTrigger": true,
      "triggerPx": "<string>",
      "children": "<unknown>",
      "isPositionTpsl": true,
      "reduceOnly": true,
      "orderType": "<string>",
      "origSz": "<string>",
      "tif": "<string>",
      "cloid": "<string>"
    },
    "status": "<string>",
    "statusTimestamp": 123
  }
]
This endpoint provides historical order data for Hyperliquid user addresses.
Drop-in ReplacementThis endpoint is a 1-1 replacement for the historicalOrders endpoint in Hyperliquid, with no limits on how far back you can query.We include two optional parameters, startTime and endTime, to facilitate flexible time range queries.
30-day interval limitThe interval between startTime and endTime cannot exceed 30 days. Paginate by issuing successive requests with 30-day windows to cover longer ranges.If startTime and endTime are omitted, the endpoint returns the most recent orders.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
type
enum<string>
required

Request type - must be 'historicalOrders'

Available options:
historicalOrders
​
user
string
required

User's wallet address (hex string)

​
startTime
integer<int64>

Start time filter (Unix timestamp in milliseconds). The interval between startTime and endTime cannot exceed 30 days.

​
endTime
integer<int64>

End time filter (Unix timestamp in milliseconds). The interval between startTime and endTime cannot exceed 30 days.

Response

Order history retrieved successfully

​
order
object
​
status
string | null

Order status

​
statusTimestamp
integer<int64> | null

Timestamp when status was last updated