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 historical data retrieval.We include two optional parameters, startTime and endTime, to facilitate flexible time range queries.

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)

​
endTime
integer<int64>

End time filter (Unix timestamp in milliseconds)

Response

Order history retrieved successfully

​
order
object
​
status
string | null

Order status

​
statusTimestamp
integer<int64> | null

Timestamp when status was last updated