Appearance
Get Order History
GET
/v1/perps/orders/history
Return perps order history over a time window. One order produces several rows, one per
status transition (e.g. placed, filled, cancelled) — group by orderId to reconstruct an
order's lifecycle.
Authorizations
apiKey
Your API key
Type
API Key (header: X-VALR-API-KEY)
apiSignature
HMAC SHA512 signature of the request (see Authentication section)
Type
API Key (header: X-VALR-SIGNATURE)
apiTimestamp
Request timestamp in milliseconds
Type
API Key (header: X-VALR-TIMESTAMP)
Parameters
Query Parameters
pair
Currency pair symbol to filter by, e.g. BTCUSDC. For xyz pairs prefix with xyz: (e.g. xyz:METAUSDC).
Type
string
startTime
Start of the time window in epoch milliseconds. Must be >= 0 and <= endTime.
Type
integer
Format
"int32"endTime
End of the time window in epoch milliseconds. Must be >= 0 and >= startTime.
Type
integer
Format
"int32"skip
Number of records to skip for pagination.
Type
integer
Format
"int32"limit
Maximum number of records to return. Silently clamped to 100 if a larger value is sent.
Type
integer
Format
"int32"Responses
Order history retrieved successfully
application/json