User

Get completed round-trip trades (server-derived)

The user’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.

Derived server-side from the persisted fill history in one consistent read, using the engine’s per-fill realized P&L as the money source of truth. This replaces client-side reconstruction: clients should render these rows as-is and never re-pair fills themselves.

Semantics:

Fills are walked chronologically per account + contract (exact full contract symbols, e.g. NQU6 and MNQU6 are distinct).
LIFO lot matching — a close pairs with the newest open lot, so long-lived position drift never pairs with fresh closes.
Fills from flattens and liquidations (user flatten, firm auto-liquidation, personal daily loss limit / profit target) are treated as flat anchors: the engine guarantees the contract is flat after them, so a close whose entry fill is missing from history can never be misread as a new entry and pair into a phantom trade.
pnl/gross_pnl are gross; fee and commission are reported separately so clients can present net if preferred.
duration_formatted reports 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).

Example:

curl "https://api.hyperprop.com/platform/v1/user/trading/trades?since=2026-07-01T00:00:00Z" \
  -H "Authorization: Bearer <jwt>"

GET

user

trading

trades

Get completed round-trip trades (server-derived)

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

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

}

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",
        "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
      }
    ],
    "total": 15,
    "generatedAt": "2026-07-15T19:20:00.000Z"
  }
}

{
  "success": false,
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

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

Query Parameters

accountId

string

Restrict to one trading account (default: all of the user's accounts)

since

string<date-time>

Only trades whose exit is at/after this time (for incremental refreshes)

Response

Completed trades

success

boolean

Example:

true

data

object

Show child attributes

⌘I

Get completed round-trip trades (server-derived)

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

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

}

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",
        "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
      }
    ],
    "total": 15,
    "generatedAt": "2026-07-15T19:20:00.000Z"
  }
}

{
  "success": false,
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

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

Platform API

Trade API

Market Data API

Get completed round-trip trades (server-derived)

Query Parameters

Response