Read trader sentiment over time
How your traders are positioned over time: how many are long and short, their long and short exposure and open P&L, and the entries they make in each time bucket, for the whole firm and per product. Each is also given for a smart-money group, your best traders by realized P&L over the last 30 days (at least 5 trades and a profit), so you can compare them with everyone else.
- A trader is long a product when their accounts’ positions in it add up to more than zero, short when less. Firm-wide, a trader long one product and short another counts on both sides.
- Exposure and open P&L use your traders’ last fill price in each contract, so they move when your traders trade.
- An entry is a fill that opens or adds to a position; a reversal counts as an entry on the new side.
- Positions are rebuilt from fills starting
carryDaysbeforesince; a position held since before that is not seen. Read the positioning endpoint for the live book. - With
assetClassormarket, only positions and executions in contracts of those markets count. The smart-money group is then your best traders in those markets. - When the smart-money group can’t be ranked in time, the response still comes back with every other series;
smartMoney.availableisfalseand the smart-money series are zero until it can be ranked again.
Results are shared for up to a minute (5 minutes for 7d) per range and filter. About 60 requests per minute per organization.
Example
curl "https://api.hyperprop.com/platform/v1/organization/insights/sentiment?range=24h&smartMoney=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/insights/sentiment \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/insights/sentiment"
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/insights/sentiment', 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/insights/sentiment",
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/insights/sentiment"
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/insights/sentiment")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/insights/sentiment")
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",
"range": "24h",
"bucketSeconds": 300,
"since": "2026-11-02T16:45:00.000Z",
"until": "2026-11-03T16:45:00.000Z",
"asOf": "2026-11-03T16:41:07.118Z",
"carryDays": 2,
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"times": [
"2026-11-03T16:35:00.000Z",
"2026-11-03T16:40:00.000Z",
"2026-11-03T16:41:07.118Z"
],
"smartMoney": {
"size": 20,
"periodDays": 30,
"minTrades": 5,
"traderIds": [
"2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b"
],
"available": true
},
"firm": {
"tradersLong": [
41,
44,
47
],
"tradersShort": [
30,
29,
25
],
"tradersInPosition": [
68,
70,
69
],
"smartTradersLong": [
9,
10,
11
],
"smartTradersShort": [
4,
3,
3
],
"smartTradersInPosition": [
13,
13,
14
],
"longNotional": [
2410000,
2560400,
2731900
],
"shortNotional": [
1870250,
1802300,
1655000
],
"smartLongNotional": [
610000,
655200,
702100
],
"smartShortNotional": [
212000,
180400,
176250
],
"longOpenPnl": [
12400.5,
15120,
18002.25
],
"shortOpenPnl": [
-8210,
-9950.5,
-12300
],
"longEntries": [
12,
18,
9
],
"shortEntries": [
7,
5,
11
],
"longEntryNotional": [
182000,
301400,
120500
],
"shortEntryNotional": [
96000,
61200,
188400
],
"smartLongEntryNotional": [
41000,
88000,
0
],
"smartShortEntryNotional": [
0,
0,
22100
]
},
"products": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"sizeUnit": "contracts",
"longQuantity": [
140,
152,
160
],
"shortQuantity": [
96,
90,
84
],
"price": null,
"tradersLong": [
41,
44,
47
],
"tradersShort": [
30,
29,
25
],
"tradersInPosition": [
68,
70,
69
],
"smartTradersLong": [
9,
10,
11
],
"smartTradersShort": [
4,
3,
3
],
"smartTradersInPosition": [
13,
13,
14
],
"longNotional": [
2410000,
2560400,
2731900
],
"shortNotional": [
1870250,
1802300,
1655000
],
"smartLongNotional": [
610000,
655200,
702100
],
"smartShortNotional": [
212000,
180400,
176250
],
"longOpenPnl": [
12400.5,
15120,
18002.25
],
"shortOpenPnl": [
-8210,
-9950.5,
-12300
],
"longEntries": [
12,
18,
9
],
"shortEntries": [
7,
5,
11
],
"longEntryNotional": [
182000,
301400,
120500
],
"shortEntryNotional": [
96000,
61200,
188400
],
"smartLongEntryNotional": [
41000,
88000,
0
],
"smartShortEntryNotional": [
0,
0,
22100
]
}
],
"productIndex": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"peakGrossNotional": 3120000,
"entries": 412,
"entryNotional": 6210500
}
],
"fills": 18204,
"live": {
"at": "2026-11-13T15:41:07.118Z",
"historyAsOf": "2026-11-13T15:40:02.000Z",
"historyCompleteUntil": "2026-11-13T15:39:00.000Z",
"firm": {},
"products": [
{}
]
}
}
}{
"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/insights/sentiment \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/insights/sentiment"
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/insights/sentiment', 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/insights/sentiment",
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/insights/sentiment"
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/insights/sentiment")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/insights/sentiment")
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",
"range": "24h",
"bucketSeconds": 300,
"since": "2026-11-02T16:45:00.000Z",
"until": "2026-11-03T16:45:00.000Z",
"asOf": "2026-11-03T16:41:07.118Z",
"carryDays": 2,
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"times": [
"2026-11-03T16:35:00.000Z",
"2026-11-03T16:40:00.000Z",
"2026-11-03T16:41:07.118Z"
],
"smartMoney": {
"size": 20,
"periodDays": 30,
"minTrades": 5,
"traderIds": [
"2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b"
],
"available": true
},
"firm": {
"tradersLong": [
41,
44,
47
],
"tradersShort": [
30,
29,
25
],
"tradersInPosition": [
68,
70,
69
],
"smartTradersLong": [
9,
10,
11
],
"smartTradersShort": [
4,
3,
3
],
"smartTradersInPosition": [
13,
13,
14
],
"longNotional": [
2410000,
2560400,
2731900
],
"shortNotional": [
1870250,
1802300,
1655000
],
"smartLongNotional": [
610000,
655200,
702100
],
"smartShortNotional": [
212000,
180400,
176250
],
"longOpenPnl": [
12400.5,
15120,
18002.25
],
"shortOpenPnl": [
-8210,
-9950.5,
-12300
],
"longEntries": [
12,
18,
9
],
"shortEntries": [
7,
5,
11
],
"longEntryNotional": [
182000,
301400,
120500
],
"shortEntryNotional": [
96000,
61200,
188400
],
"smartLongEntryNotional": [
41000,
88000,
0
],
"smartShortEntryNotional": [
0,
0,
22100
]
},
"products": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"sizeUnit": "contracts",
"longQuantity": [
140,
152,
160
],
"shortQuantity": [
96,
90,
84
],
"price": null,
"tradersLong": [
41,
44,
47
],
"tradersShort": [
30,
29,
25
],
"tradersInPosition": [
68,
70,
69
],
"smartTradersLong": [
9,
10,
11
],
"smartTradersShort": [
4,
3,
3
],
"smartTradersInPosition": [
13,
13,
14
],
"longNotional": [
2410000,
2560400,
2731900
],
"shortNotional": [
1870250,
1802300,
1655000
],
"smartLongNotional": [
610000,
655200,
702100
],
"smartShortNotional": [
212000,
180400,
176250
],
"longOpenPnl": [
12400.5,
15120,
18002.25
],
"shortOpenPnl": [
-8210,
-9950.5,
-12300
],
"longEntries": [
12,
18,
9
],
"shortEntries": [
7,
5,
11
],
"longEntryNotional": [
182000,
301400,
120500
],
"shortEntryNotional": [
96000,
61200,
188400
],
"smartLongEntryNotional": [
41000,
88000,
0
],
"smartShortEntryNotional": [
0,
0,
22100
]
}
],
"productIndex": [
{
"productKey": "MNQ",
"rootSymbol": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"assetClass": "future",
"peakGrossNotional": 3120000,
"entries": 412,
"entryNotional": 6210500
}
],
"fills": 18204,
"live": {
"at": "2026-11-13T15:41:07.118Z",
"historyAsOf": "2026-11-13T15:40:02.000Z",
"historyCompleteUntil": "2026-11-13T15:39:00.000Z",
"firm": {},
"products": [
{}
]
}
}
}{
"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"
}