!!! info "[ApiOrderHistoryRequest](/../../schemas/api_order_history_request)"
Retrieves the order history for the account.
Pagination works as follows:
- We perform a reverse chronological lookup, starting from `end_time`. If `end_time` is not set, we start from the most recent data.
- The lookup is limited to `limit` records. If more data is requested, the response will contain a `next` cursor for you to query the next page.
- If a `cursor` is provided, it will be used to fetch results from that point onwards.
- Pagination will continue until the `start_time` is reached. If `start_time` is not set, pagination will continue as far back as our data retention policy allows.
|Name
`Lite`|Type|Required
`Default`| Description |
|-|-|-|-|
|sub_account_id
`sa` |string|True|The subaccount ID to filter by|
|kind
`k` |[Kind]|False
`all`|The kind filter to apply. If nil, this defaults to all kinds. Otherwise, only entries matching the filter will be returned|
|base
`b` |[string]|False
`all`|The base filter to apply. If nil, this defaults to all bases. Otherwise, only entries matching the filter will be returned|
|quote
`q` |[string]|False
`all`|The quote filter to apply. If nil, this defaults to all quotes. Otherwise, only entries matching the filter will be returned|
|start_time
`st` |string|False
`0`|The start time to apply in nanoseconds. If nil, this defaults to all start times. Otherwise, only entries matching the filter will be returned|
|end_time
`et` |string|False
`now()`|The end time to apply in nanoseconds. If nil, this defaults to all end times. Otherwise, only entries matching the filter will be returned|
|limit
`l` |integer|False
`500`|The limit to query for. Defaults to 500; Max 1000|
|cursor
`c` |string|False
`''`|The cursor to indicate when to start the query from|
??? info "[Kind](/../../schemas/kind)"
The list of asset kinds that are supported on the GRVT exchange
|Value| Description |
|-|-|
|`PERPETUAL` = 1|the perpetual asset kind|
|`FUTURE` = 2|the future asset kind|
|`CALL` = 3|the call option asset kind|
|`PUT` = 4|the put option asset kind|