Get completed round-trip trades (server-derived)
The trader’s completed round-trip trades — one row per position episode (open-from-flat to back-to-flat), newest exit first. Scale-ins and scale-outs are merged into the episode’s single trade. Render these rows as-is rather than re-pairing fills yourself.
Semantics:
- Trades are paired per account and contract (exact full contract symbols, e.g.
NQU6andMNQU6are distinct). - LIFO matching — a close pairs with the newest open lot.
- A flatten or liquidation always ends the episode.
pnl/gross_pnlare gross;feeandcommissionare reported separately so clients can present net if preferred.duration_formattedreports sub-second round trips (e.g. an instant liquidation) as<1s.- Positions still open at query time are not included (the round trip isn’t complete yet).
- Orders can fill in several executions at different prices. The journal uses each order’s executed quantity and volume-weighted average fill price; executed contracts still count when the rest of the order was cancelled.
- A request reads at most 150,000 fills. A longer history answers 422
JOURNAL_TOO_LARGE: passaccountIdorsinceto narrow it. - Requests without
accountIdandsincecount against a lower allowance of 30 a minute; usesincefor incremental refreshes.
Example — partner session token:
curl "https://api.hyperprop.com/platform/v1/user/trading/trades?since=2026-07-01T00:00:00Z" \
-H "Authorization: Bearer <partner-session-token>"
Example — partner app, with API key headers:
curl "https://api.hyperprop.com/platform/v1/user/trading/trades?since=2026-07-01T00:00:00Z" \
-H "X-Partner-App-Id: your-app-uuid" \
-H "X-Partner-App-Secret: your-app-secret" \
-H "X-Trader-Api-Key: hpk_the_traders_key" \
-H "X-Trader-Email: trader@example.com"
Rate limit. Up to 120 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/tradesimport requests
url = "https://api.hyperprop.com/platform/v1/user/trading/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hyperprop.com/platform/v1/user/trading/trades', 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/trades",
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/trades"
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/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/user/trading/trades")
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": {
"trades": [
{
"id": "trade-31023653-a76ea170",
"account_id": "<string>",
"contract": "NQU6",
"product": "CME",
"symbol": "NQ",
"side": "long",
"entry_order_id": "<string>",
"entry_price": 29771.25,
"entry_time": "2026-07-13T10:00:22.498Z",
"exit_order_id": "<string>",
"exit_price": 29774,
"exit_time": "2026-07-13T10:00:35.260Z",
"entry_order_ids": [
"<string>"
],
"exit_order_ids": [
"<string>"
],
"position_group": "<string>",
"quantity": 1,
"duration_ms": 12762,
"duration_formatted": "12s",
"pnl": 55,
"gross_pnl": 55,
"pnl_ticks": 11,
"pnl_percent": 0.0092,
"fee": 3,
"commission": 0,
"liquidation_fee": 0
}
],
"total": 15,
"generatedAt": "2026-07-15T19:20:00.000Z"
}
}{
"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": 422,
"error": "Unprocessable Entity",
"message": "This trading history is too large to load at once. Choose an account or a start date.",
"code": "JOURNAL_TOO_LARGE"
}{
"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/tradesimport requests
url = "https://api.hyperprop.com/platform/v1/user/trading/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hyperprop.com/platform/v1/user/trading/trades', 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/trades",
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/trades"
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/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/user/trading/trades")
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": {
"trades": [
{
"id": "trade-31023653-a76ea170",
"account_id": "<string>",
"contract": "NQU6",
"product": "CME",
"symbol": "NQ",
"side": "long",
"entry_order_id": "<string>",
"entry_price": 29771.25,
"entry_time": "2026-07-13T10:00:22.498Z",
"exit_order_id": "<string>",
"exit_price": 29774,
"exit_time": "2026-07-13T10:00:35.260Z",
"entry_order_ids": [
"<string>"
],
"exit_order_ids": [
"<string>"
],
"position_group": "<string>",
"quantity": 1,
"duration_ms": 12762,
"duration_formatted": "12s",
"pnl": 55,
"gross_pnl": 55,
"pnl_ticks": 11,
"pnl_percent": 0.0092,
"fee": 3,
"commission": 0,
"liquidation_fee": 0
}
],
"total": 15,
"generatedAt": "2026-07-15T19:20:00.000Z"
}
}{
"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": 422,
"error": "Unprocessable Entity",
"message": "This trading history is too large to load at once. Choose an account or a start date.",
"code": "JOURNAL_TOO_LARGE"
}{
"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"
}