Organization

Get fills for a trading day

Returns every fill (trade execution) for your organization’s accounts during a CME trading day.

CME trading day definition: A CME trading day runs from 17:00 CT the previous calendar day to 16:00 CT the current day. Example: “2026-03-11” covers 2026-03-10 17:00 CT → 2026-03-11 16:00 CT.

Filtering:

Param	Description
`tradingDay`	Date to query (defaults to today)
`accountId`	One account UUID, or a comma-separated list (max 100) to scope to a subset of accounts
`symbol`	Filter by contract symbol (e.g., ES, NQ)

Why an order happened: every fill carries the engine’s free-text reason and a stable trigger derived from it — auto_liquidation_breach (a trading rule was breached), auto_liquidation_eod (end-of-day market-close flatten), personal_risk, admin_lockout, time_machine, contract_expiry, auto_cancel, or trader for the trader’s own actions — plus a display triggerLabel.

Pagination — two interchangeable styles:

Cursor (recommended for large days): read nextCursor from the response and send it back as ?cursor=. Keep going while hasMore is true; the last page returns hasMore: false and nextCursor: null. Do not send offset alongside a cursor — it is ignored. Note that total counts the rows remaining from your cursor position onward, so it shrinks as you page.

Offset: send limit (default 500, max 1000) and offset, and page until hasMore is false. Here total is the full count for the trading day.

Fills are ordered oldest first, so both styles stay stable while a day is still being traded — new fills land after your current position rather than shifting rows you have already read.

curl -X GET "https://api.hyperprop.com/platform/v1/organization/snapshots/fills?tradingDay=2026-03-11&limit=1000" \
  -H "X-API-Key: hp_live_your_key_here"
# → { "data": { "hasMore": true, "nextCursor": "eyJmaWxsZWRfYXQiOi4uLn0", ... } }
curl -X GET "https://api.hyperprop.com/platform/v1/organization/snapshots/fills?tradingDay=2026-03-11&limit=1000&cursor=eyJmaWxsZWRfYXQiOi4uLn0" \
  -H "X-API-Key: hp_live_your_key_here"

GET

organization

snapshots

fills

Get fills for a trading day

curl --request GET \
  --url https://api.hyperprop.com/platform/v1/organization/snapshots/fills \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.hyperprop.com/platform/v1/organization/snapshots/fills"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.hyperprop.com/platform/v1/organization/snapshots/fills', 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/organization/snapshots/fills",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/organization/snapshots/fills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	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/organization/snapshots/fills")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "tradingDay": "2026-03-11",
    "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
    "organizationName": "FakePropFirm",
    "total": 1847,
    "fills": [
      {
        "id": "ae33cf90-c2e8-40a9-a45b-889e3e44fcab",
        "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "userId": "f994bc02-343c-4026-8a57-afc085eca8d5",
        "contract": "ESH6",
        "product": "CME",
        "symbol": "ES",
        "side": "buy",
        "orderType": "market",
        "quantity": 2,
        "filledQuantity": 2,
        "filledPrice": 6945.5,
        "limitPrice": null,
        "stopPrice": null,
        "reason": "Auto-liquidation: Max drawdown breached",
        "trigger": "auto_liquidation_breach",
        "triggerLabel": "Auto Liquidation: Breach",
        "filledAt": "2026-03-11T14:30:01.123Z"
      }
    ],
    "hasMore": true,
    "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9",
    "pagination": {
      "total": 1847,
      "limit": 500,
      "offset": 0,
      "hasMore": true,
      "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9"
    }
  }
}

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

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Account not found in your organization",
  "code": "ACCOUNT_NOT_FOUND"
}

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

Authorizations

Authorization

string

header

required

JWT Bearer token for user session auth. Format: "Bearer {token}". Used by User and Organization endpoints.

Query Parameters

tradingDay

string

CME trading day (YYYY-MM-DD). Defaults to today.

Pattern: ^\d{4}-\d{2}-\d{2}$

accountId

string

Filter to specific accounts: one account UUID or a comma-separated list (max 100). Every ID must belong to your organization.

symbol

string

Filter by symbol (e.g., ES, NQ, CL)

limit

integer

default:500

Max rows returned

Required range: 1 <= x <= 1000

offset

integer

default:0

Pagination offset

Required range: x >= 0

cursor

string

Cursor for pagination. Pass the nextCursor value from the previous response to get the next page. When using cursor, do not send offset — it will be ignored.

How it works: The cursor is an opaque string that points to the last item you received. The server uses it to efficiently fetch the next set of results without scanning previous pages.

Backwards compatible: If you don't send a cursor, offset/limit pagination works as before.

Response

Fills retrieved

success

boolean

Example:

true

data

object

Show child attributes

Example:

{
  "tradingDay": "2026-03-11",
  "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
  "organizationName": "FakePropFirm",
  "total": 1847,
  "fills": [
    {
      "id": "ae33cf90-c2e8-40a9-a45b-889e3e44fcab",
      "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "userId": "f994bc02-343c-4026-8a57-afc085eca8d5",
      "contract": "ESH6",
      "product": "CME",
      "symbol": "ES",
      "side": "buy",
      "orderType": "market",
      "quantity": 2,
      "filledQuantity": 2,
      "filledPrice": 6945.5,
      "limitPrice": null,
      "stopPrice": null,
      "reason": "Auto-liquidation: Max drawdown breached",
      "trigger": "auto_liquidation_breach",
      "triggerLabel": "Auto Liquidation: Breach",
      "filledAt": "2026-03-11T14:30:01.123Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9",
  "pagination": {
    "total": 1847,
    "limit": 500,
    "offset": 0,
    "hasMore": true,
    "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9"
  }
}

⌘I

Get fills for a trading day

curl --request GET \
  --url https://api.hyperprop.com/platform/v1/organization/snapshots/fills \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.hyperprop.com/platform/v1/organization/snapshots/fills"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.hyperprop.com/platform/v1/organization/snapshots/fills', 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/organization/snapshots/fills",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/organization/snapshots/fills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	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/organization/snapshots/fills")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "tradingDay": "2026-03-11",
    "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
    "organizationName": "FakePropFirm",
    "total": 1847,
    "fills": [
      {
        "id": "ae33cf90-c2e8-40a9-a45b-889e3e44fcab",
        "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "userId": "f994bc02-343c-4026-8a57-afc085eca8d5",
        "contract": "ESH6",
        "product": "CME",
        "symbol": "ES",
        "side": "buy",
        "orderType": "market",
        "quantity": 2,
        "filledQuantity": 2,
        "filledPrice": 6945.5,
        "limitPrice": null,
        "stopPrice": null,
        "reason": "Auto-liquidation: Max drawdown breached",
        "trigger": "auto_liquidation_breach",
        "triggerLabel": "Auto Liquidation: Breach",
        "filledAt": "2026-03-11T14:30:01.123Z"
      }
    ],
    "hasMore": true,
    "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9",
    "pagination": {
      "total": 1847,
      "limit": 500,
      "offset": 0,
      "hasMore": true,
      "nextCursor": "eyJmaWxsZWRfYXQiOiIyMDI2LTAzLTExVDE0OjMwOjAxLjEyM1oiLCJpZCI6ImFlMzNjZjkwLWMyZTgtNDBhOS1hNDViLTg4OWUzZTQ0ZmNhYiJ9"
    }
  }
}

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

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Account not found in your organization",
  "code": "ACCOUNT_NOT_FOUND"
}

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

Platform API

Trade API

Market Data API

Get fills for a trading day

Authorizations

Query Parameters

Response