Get live exposure by product and trader
Your organization’s open positions right now, aggregated: per product the traders long and short, quantities and the net and gross exposure, the firm’s totals, and with traders=true the exposure of each trader. The figures follow every position change within about a second.
To receive them as they change instead of asking, subscribe on the organization event stream (/organization/events/stream): send {"type": "subscribe", "topic": "live.positioning"}; you receive subscribed, then a live.positioning message with the same firm and products at most about once per second while they change.
Exposure is quantity × mark × point value, each contract valued at its latest mark; open P&L uses the same mark. A trader counts as long a product when their positions in it sum to long. With assetClass or market, only positions and executions in contracts of those markets count.
The first request for your organization starts the live figures and answers status: "starting"; they are ready within seconds. About 60 requests per minute per organization.
Example
curl "https://api.hyperprop.com/platform/v1/organization/risk/positioning/live?traders=true&traderLimit=20" \
-H "X-API-Key: hp_live_your_key_here"
Permissions: requires view access to “Traders & accounts”.
Access: read-only and full-access API keys. Dashboard members need view access to Traders & accounts.
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/positioning/live \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/positioning/live"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hyperprop.com/platform/v1/organization/risk/positioning/live', 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/risk/positioning/live",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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/risk/positioning/live"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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/organization/risk/positioning/live")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/positioning/live")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"organizationId": "55555555-5555-4555-8555-555555555555",
"status": "live",
"retryAfterSeconds": 2,
"asOf": "2026-11-13T15:41:07.118Z",
"liveSince": "2026-11-13T15:30:02.004Z",
"staleSince": null,
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"firm": {
"tradersLong": 412,
"tradersShort": 388,
"tradersInPosition": 800,
"smartTradersLong": 0,
"smartTradersShort": 0,
"smartTradersInPosition": 0,
"longNotional": 18240500,
"shortNotional": 16120250,
"netNotional": 2120250,
"grossNotional": 34360750,
"smartLongNotional": 0,
"smartShortNotional": 0,
"longOpenPnl": 41200.5,
"shortOpenPnl": -12800.25,
"accountsInPosition": 1240,
"openPositions": 1512
},
"products": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"sizeUnit": "contracts",
"tradersLong": 412,
"tradersShort": 388,
"tradersInPosition": 800,
"smartTradersLong": 0,
"smartTradersShort": 0,
"smartTradersInPosition": 0,
"longNotional": 18240500,
"shortNotional": 16120250,
"netNotional": 2120250,
"grossNotional": 34360750,
"smartLongNotional": 0,
"smartShortNotional": 0,
"longOpenPnl": 41200.5,
"shortOpenPnl": -12800.25,
"longQuantity": 1840,
"shortQuantity": 1610,
"netQuantity": 230,
"price": null
}
],
"traders": [
{
"traderId": "0f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a",
"traderName": "Alex Trader",
"traderEmail": "alex@example.com",
"accounts": 2,
"longNotional": 210400,
"shortNotional": 0,
"netNotional": 210400,
"grossNotional": 210400,
"openPnl": 1250.5,
"products": [
{
"productKey": "MNQ",
"netQuantity": 4,
"netNotional": 210400
}
]
}
]
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Unknown market: CMX. Use CME, CBOT, NYMEX, COMEX, HDL, BINANCE, HYPERLIQUID",
"code": "INVALID_MARKET"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "This API key does not have admin permissions",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"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"
}Authorizations
Organization API key (hp_live_...), sent in the X-API-Key header. Create, rotate and restrict keys in the dashboard or with the API keys endpoints; an organization can have two active keys, so you can rotate without downtime. A full-access key can call every endpoint in this reference. A read-only key can call GET endpoints (and create a trading stream token); any other request returns 403 READ_ONLY_KEY. A key with an IP allowlist returns 403 IP_NOT_ALLOWED from any other address. Each endpoint lists which keys can call it under Access.
Headers
Query Parameters
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/positioning/live \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/positioning/live"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hyperprop.com/platform/v1/organization/risk/positioning/live', 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/risk/positioning/live",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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/risk/positioning/live"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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/organization/risk/positioning/live")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/positioning/live")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"organizationId": "55555555-5555-4555-8555-555555555555",
"status": "live",
"retryAfterSeconds": 2,
"asOf": "2026-11-13T15:41:07.118Z",
"liveSince": "2026-11-13T15:30:02.004Z",
"staleSince": null,
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"firm": {
"tradersLong": 412,
"tradersShort": 388,
"tradersInPosition": 800,
"smartTradersLong": 0,
"smartTradersShort": 0,
"smartTradersInPosition": 0,
"longNotional": 18240500,
"shortNotional": 16120250,
"netNotional": 2120250,
"grossNotional": 34360750,
"smartLongNotional": 0,
"smartShortNotional": 0,
"longOpenPnl": 41200.5,
"shortOpenPnl": -12800.25,
"accountsInPosition": 1240,
"openPositions": 1512
},
"products": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"sizeUnit": "contracts",
"tradersLong": 412,
"tradersShort": 388,
"tradersInPosition": 800,
"smartTradersLong": 0,
"smartTradersShort": 0,
"smartTradersInPosition": 0,
"longNotional": 18240500,
"shortNotional": 16120250,
"netNotional": 2120250,
"grossNotional": 34360750,
"smartLongNotional": 0,
"smartShortNotional": 0,
"longOpenPnl": 41200.5,
"shortOpenPnl": -12800.25,
"longQuantity": 1840,
"shortQuantity": 1610,
"netQuantity": 230,
"price": null
}
],
"traders": [
{
"traderId": "0f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a",
"traderName": "Alex Trader",
"traderEmail": "alex@example.com",
"accounts": 2,
"longNotional": 210400,
"shortNotional": 0,
"netNotional": 210400,
"grossNotional": 210400,
"openPnl": 1250.5,
"products": [
{
"productKey": "MNQ",
"netQuantity": 4,
"netNotional": 210400
}
]
}
]
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Unknown market: CMX. Use CME, CBOT, NYMEX, COMEX, HDL, BINANCE, HYPERLIQUID",
"code": "INVALID_MARKET"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "This API key does not have admin permissions",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"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"
}