Organization

Get account balances (bulk, reconciliation-friendly)

Returns the current balance of every trading account in your organization in one compact list — one row per account, balance fields only, no plan/rule/trader/purchase detail.

Use this to reconcile the balances you hold against ours. It is the authoritative post-fill balance, the same value GET /organization/trading-accounts/{id} reports as currentBalance; it just comes back for hundreds of accounts per call instead of one.

Each row:

Field	Meaning
`currentBalance`	Balance after the last booked fill (realized P&L, fees and commissions applied). Open positions are not marked in.
`realizedPnl`	`currentBalance − initialBalance` — what you get by summing `pnl − fee − commission` over every fill on the account.
`highWaterMark`	Highest balance the account has reached (drawdown reference for trailing rules).
`dailyStartingBalance`	Balance at the start of the current trading day.
`updatedAt`	When the account last changed (fill, status change, day roll).

Incremental sync: Store the asOf value from a response and pass it back as ?updatedSince= on the next call; you get only the accounts that changed in between, ordered most-recently-changed first.

Example queries:

# Every account, 500 per page
GET /organization/balances?limit=500

# Just the accounts that changed since your last pass
GET /organization/balances?updatedSince=2026-09-08T13:00:00Z

# A specific set of accounts
GET /organization/balances?accountId=7c9e6679-...,9d1e6679-...

# One customer's accounts
GET /organization/balances?customerId=mffu-cust-4471

Pagination: offset/limit, or follow pagination.nextCursor for stable paging while balances keep moving.

GET

organization

balances

Get account balances (bulk, reconciliation-friendly)

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

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

fetch('https://api.hyperprop.com/platform/v1/organization/balances', 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/balances",
  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/balances"

	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/balances")

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": {
    "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
    "asOf": "2026-09-08T15:42:10.318Z",
    "balances": [
      {
        "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "accountNumber": "ACC-7845KXPQ",
        "customerId": "mffu-cust-4471",
        "type": "evaluation",
        "status": "in_progress",
        "initialBalance": 25000,
        "currentBalance": 25806.63,
        "realizedPnl": 806.63,
        "highWaterMark": 25955.41,
        "dailyStartingBalance": 25434.67,
        "updatedAt": "2026-09-08T15:41:52.104Z"
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 100,
      "offset": 0,
      "hasMore": false,
      "nextCursor": null
    }
  }
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "accountId accepts at most 200 IDs per request",
  "code": "TOO_MANY_ACCOUNT_IDS"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired session"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Account(s) not found in your organization: 9d1e6679-7425-40de-944b-e07fc1f90ae8",
  "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

accountId

string

Scope to specific accounts: one account UUID or a comma-separated list (max 200). Every ID must belong to your organization, otherwise 404 ACCOUNT_NOT_FOUND.

customerId

string

Exact match on the customerId you set at account creation — all balances for one of your customers.

Maximum string length: 255

status

enum<string>

Filter by account status

Available options:

not_started,

in_progress,

passed,

failed,

expired

updatedSince

string

Only accounts whose balance or state changed at or after this instant (ISO 8601). Use the asOf value from your previous response to fetch just what moved since then.

limit

integer

default:100

Results per page (default: 100, max: 500)

Required range: 1 <= x <= 500

offset

integer

default:0

Skip this many results (for pagination)

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

Success - Returns one balance row per account

success

boolean

Example:

true

data

object

Show child attributes

Example:

{
  "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
  "asOf": "2026-09-08T15:42:10.318Z",
  "balances": [
    {
      "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "accountNumber": "ACC-7845KXPQ",
      "customerId": "mffu-cust-4471",
      "type": "evaluation",
      "status": "in_progress",
      "initialBalance": 25000,
      "currentBalance": 25806.63,
      "realizedPnl": 806.63,
      "highWaterMark": 25955.41,
      "dailyStartingBalance": 25434.67,
      "updatedAt": "2026-09-08T15:41:52.104Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 100,
    "offset": 0,
    "hasMore": false,
    "nextCursor": null
  }
}

⌘I

Get account balances (bulk, reconciliation-friendly)

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

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

fetch('https://api.hyperprop.com/platform/v1/organization/balances', 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/balances",
  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/balances"

	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/balances")

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": {
    "organizationId": "a6fcc0ce-eb28-4f43-b256-96a3144b0d34",
    "asOf": "2026-09-08T15:42:10.318Z",
    "balances": [
      {
        "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "accountNumber": "ACC-7845KXPQ",
        "customerId": "mffu-cust-4471",
        "type": "evaluation",
        "status": "in_progress",
        "initialBalance": 25000,
        "currentBalance": 25806.63,
        "realizedPnl": 806.63,
        "highWaterMark": 25955.41,
        "dailyStartingBalance": 25434.67,
        "updatedAt": "2026-09-08T15:41:52.104Z"
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 100,
      "offset": 0,
      "hasMore": false,
      "nextCursor": null
    }
  }
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "accountId accepts at most 200 IDs per request",
  "code": "TOO_MANY_ACCOUNT_IDS"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired session"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Account(s) not found in your organization: 9d1e6679-7425-40de-944b-e07fc1f90ae8",
  "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 account balances (bulk, reconciliation-friendly)

Authorizations

Query Parameters

Response