Get order history (keyset-paginated)
The trader’s order history across all their accounts, newest first.
Pagination is keyset-based (cursor), not offset-based: pages are anchored to the last row you received, so new fills landing while you page can never shift rows between pages or skip them. Pass the nextCursor from each response to get the next page; nextCursor: null means you have everything.
Rows voided by a trading-day revert (Time Machine) are excluded.
Example — first page, then next (partner session token):
curl "https://api.hyperprop.com/platform/v1/user/trading/orders?status=filled&limit=100" \
-H "Authorization: Bearer <partner-session-token>"
curl "https://api.hyperprop.com/platform/v1/user/trading/orders?status=filled&limit=100&cursor=2026-07-13T10:00:35.260Z|8f3593a6-..." \
-H "Authorization: Bearer <partner-session-token>"
Rate limit. Up to 300 requests a minute per trader, whichever way the trader is signed in; with a personal API key or a partner app the count holds across all our servers. One partner app can make at most 600 journal requests a minute across all its traders. Beyond a limit the API returns 429 with code RATE_LIMITED and a Retry-After header in seconds.
Partner access (read-only). Approved partner apps can read a trader’s journal on the trader’s behalf, in either of two ways:
- API key headers — send
X-Partner-App-Id,X-Partner-App-Secretand the trader’s key inX-Trader-Api-Key. Optionally addX-Trader-Email(must match the key’s owner) andX-Partner-Firm(limits results to one firm). - Partner session token — send the token from
POST /trade/partner/sessionasAuthorization: Bearer <token>. A token created for one firm only returns that firm’s accounts.
Without a firm, results cover the trader’s accounts at every firm. Partner access is read-only: it works on the journal endpoints only. A bad app secret, trader key or email returns 401; a firm where the trader has no accounts returns 403; repeated failures return 429.
Personal API key access (read-only). Send your own key (hpp_...) in X-Trader-Api-Key with no partner app headers, or the token from POST /trade/api-keys/session as Authorization: Bearer <token>. Results cover all your accounts, on every market. Market data isn’t included. A revoked key returns 401.
curl --request GET \
--url https://api.hyperprop.com/platform/v1/user/trading/ordersimport requests
url = "https://api.hyperprop.com/platform/v1/user/trading/orders"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hyperprop.com/platform/v1/user/trading/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hyperprop.com/platform/v1/user/trading/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hyperprop.com/platform/v1/user/trading/orders"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hyperprop.com/platform/v1/user/trading/orders")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/user/trading/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"orders": [
{
"id": "<string>",
"account_id": "<string>",
"user_id": "<string>",
"contract": "NQU6",
"product": "CME",
"symbol": "NQ",
"side": "buy",
"order_type": "market",
"quantity": 1,
"filled_quantity": 1,
"filled_price": 29774,
"limit_price": 123,
"stop_price": 123,
"status": "filled",
"reject_reason": "<string>",
"reason": "<string>",
"filled_at": "<string>",
"processed_at": "<string>",
"updated_at": "<string>",
"fee": 3,
"commission": 0,
"realized_pnl": 55,
"liquidation_fee": 0
}
],
"nextCursor": "2026-07-13T10:00:35.260Z|33333333-3333-4333-8333-333333333333",
"hasMore": true
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid cursor: pass nextCursor from the previous page unchanged",
"code": "INVALID_CURSOR"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "No accounts at this firm for this trader",
"code": "FORBIDDEN"
}{
"success": false,
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"success": false,
"statusCode": 500,
"error": "Internal Server Error",
"message": "An unexpected error occurred",
"code": "INTERNAL_ERROR"
}{
"statusCode": 504,
"error": "Gateway Timeout",
"message": "The request did not complete within 25 seconds. Try again, or narrow it (for example a shorter date range).",
"code": "REQUEST_TIMEOUT"
}Headers
Query Parameters
curl --request GET \
--url https://api.hyperprop.com/platform/v1/user/trading/ordersimport requests
url = "https://api.hyperprop.com/platform/v1/user/trading/orders"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hyperprop.com/platform/v1/user/trading/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hyperprop.com/platform/v1/user/trading/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hyperprop.com/platform/v1/user/trading/orders"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hyperprop.com/platform/v1/user/trading/orders")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/user/trading/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"orders": [
{
"id": "<string>",
"account_id": "<string>",
"user_id": "<string>",
"contract": "NQU6",
"product": "CME",
"symbol": "NQ",
"side": "buy",
"order_type": "market",
"quantity": 1,
"filled_quantity": 1,
"filled_price": 29774,
"limit_price": 123,
"stop_price": 123,
"status": "filled",
"reject_reason": "<string>",
"reason": "<string>",
"filled_at": "<string>",
"processed_at": "<string>",
"updated_at": "<string>",
"fee": 3,
"commission": 0,
"realized_pnl": 55,
"liquidation_fee": 0
}
],
"nextCursor": "2026-07-13T10:00:35.260Z|33333333-3333-4333-8333-333333333333",
"hasMore": true
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid cursor: pass nextCursor from the previous page unchanged",
"code": "INVALID_CURSOR"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "No accounts at this firm for this trader",
"code": "FORBIDDEN"
}{
"success": false,
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"success": false,
"statusCode": 500,
"error": "Internal Server Error",
"message": "An unexpected error occurred",
"code": "INTERNAL_ERROR"
}{
"statusCode": 504,
"error": "Gateway Timeout",
"message": "The request did not complete within 25 seconds. Try again, or narrow it (for example a shorter date range).",
"code": "REQUEST_TIMEOUT"
}