Partner access

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>"

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-Secret and the trader’s key in X-Trader-Api-Key. Optionally add X-Trader-Email (must match the key’s owner) and X-Partner-Firm (limits results to one firm).
Partner session token — send the token from POST /trade/partner/session as Authorization: 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.

GET

user

trading

orders

Get order history (keyset-paginated)

curl --request GET \
  --url https://api.hyperprop.com/platform/v1/user/trading/orders

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))

}

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
      }
    ],
    "nextCursor": "2026-07-13T10:00:35.260Z|8f3593a6-ed22-4d3d-bd14-e7d3cd14f5c0",
    "hasMore": true
  }
}

{
  "success": false,
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Unknown firm",
  "code": "BAD_REQUEST"
}

{
  "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 failed attempts; retry in a minute",
  "code": "TOO_MANY_REQUESTS"
}

{
  "success": false,
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "code": "INTERNAL_ERROR"
}

Headers

authorization

string

Bearer <token>: the trader's own session, or a partner session token from POST /trade/partner/session

x-partner-app-id

string

Partner access: your partner app id

x-partner-app-secret

string

Partner access: your partner app secret (server-side only)

x-trader-api-key

string

Partner access: the trader's API key (hpk_...)

x-trader-email

string

Partner access, optional: the trader's sign-in email; must match the key's owner

x-partner-firm

string

Partner access, optional: organization id, slug or name; limits results to the trader's accounts at that firm

Query Parameters

accountId

string

Restrict to one trading account

contract

string

Restrict to one contract (full symbol)

status

enum<string>

Filter by order status (omit for all). partially_filled orders are still working with part of their quantity executed.

Available options:

filled,

partially_filled,

cancelled,

rejected

limit

integer

default:100

Page size

Required range: 1 <= x <= 1000

cursor

string

Opaque cursor from the previous page's nextCursor

Response

Order history page

success

boolean

Example:

true

data

object

Show child attributes

⌘I

Get order history (keyset-paginated)

curl --request GET \
  --url https://api.hyperprop.com/platform/v1/user/trading/orders

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))

}

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
      }
    ],
    "nextCursor": "2026-07-13T10:00:35.260Z|8f3593a6-ed22-4d3d-bd14-e7d3cd14f5c0",
    "hasMore": true
  }
}

{
  "success": false,
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Unknown firm",
  "code": "BAD_REQUEST"
}

{
  "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 failed attempts; retry in a minute",
  "code": "TOO_MANY_REQUESTS"
}

{
  "success": false,
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "code": "INTERNAL_ERROR"
}

Platform API

Trade API

Get order history (keyset-paginated)

Headers

Query Parameters

Response