Appearance
Get Trade History
GET
/v1/perps/trade-history
Return perps trade history (individual fills) over a time window. Group by orderId to
aggregate fills of a single order. realisedPnl on a fill is gross — subtract fees and
funding for the net figure.
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
Trade history retrieved successfully
application/json