Read one trader's risk findings with their proof
Every finding of the daily risk reports that names the trader, newest first, each with its level, the reasons in words, the rule that fired with the values observed, the other traders involved, and the evidence: both positions with entry, exit, size and profit per side and the seconds they overlapped; for a shared device or address, who used it, when, and how long their sessions overlapped. coverage says which trading days are included and which failed or are still to come. At most 500 findings (truncated). stake is the money at stake with the trader, as on their inbox row.
curl "https://api.hyperprop.com/platform/v1/organization/risk/traders/2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b/findings?days=30" \
-H "X-API-Key: hp_live_your_key_here"
Permissions: requires view access to “Traders & accounts”. Full sign-in addresses and device ids need “Risk investigations”; without it they are shortened.
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/traders/{traderId}/findings \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/traders/{traderId}/findings"
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/traders/{traderId}/findings', 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/traders/{traderId}/findings",
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/traders/{traderId}/findings"
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/traders/{traderId}/findings")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/traders/{traderId}/findings")
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": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "<string>",
"accounts": [
{}
],
"coverage": {
"from": "2026-11-06",
"to": "2026-11-12",
"complete": false,
"days": [
{
"tradingDay": "2026-11-11",
"state": "failed",
"expectedAt": "2026-11-16T23:10:00.000Z",
"reports": {},
"truncated": [
"<string>"
]
}
],
"failedDays": 1,
"pendingDays": 0,
"truncatedDays": 0,
"missingDays": 0
},
"review": {
"state": "<string>",
"outcome": "<string>",
"reason": "<string>",
"note": "<string>",
"updatedAt": "<string>"
},
"findings": [
{
"findingId": "5f0e8a1c-3b2d-5c4e-9f6a-7b8c9d0e1f2a",
"report": "hedge_pairs",
"tradingDay": "2026-11-12",
"level": "high",
"flags": true,
"reasons": [
{
"code": "repeat_days",
"text": "Also seen on 2 other days of the last 30"
}
],
"summary": "Opposite NQ positions with another trader for 412 s",
"rule": {
"name": "<string>",
"observed": {}
},
"traderIds": [
"<string>"
],
"otherTraders": [
{
"traderId": "<string>",
"traderName": "<string>"
}
],
"pnl": 260.5,
"evidence": {},
"redacted": false,
"supersededAt": "<string>"
}
],
"truncated": true,
"stake": {
"payableProfit": 12400.5,
"fundedAccounts": 2,
"paidBeforeReview": 850,
"payoutPending": "<string>"
}
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid request data",
"code": "BAD_REQUEST"
}{
"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/traders/{traderId}/findings \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/traders/{traderId}/findings"
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/traders/{traderId}/findings', 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/traders/{traderId}/findings",
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/traders/{traderId}/findings"
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/traders/{traderId}/findings")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/traders/{traderId}/findings")
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": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "<string>",
"accounts": [
{}
],
"coverage": {
"from": "2026-11-06",
"to": "2026-11-12",
"complete": false,
"days": [
{
"tradingDay": "2026-11-11",
"state": "failed",
"expectedAt": "2026-11-16T23:10:00.000Z",
"reports": {},
"truncated": [
"<string>"
]
}
],
"failedDays": 1,
"pendingDays": 0,
"truncatedDays": 0,
"missingDays": 0
},
"review": {
"state": "<string>",
"outcome": "<string>",
"reason": "<string>",
"note": "<string>",
"updatedAt": "<string>"
},
"findings": [
{
"findingId": "5f0e8a1c-3b2d-5c4e-9f6a-7b8c9d0e1f2a",
"report": "hedge_pairs",
"tradingDay": "2026-11-12",
"level": "high",
"flags": true,
"reasons": [
{
"code": "repeat_days",
"text": "Also seen on 2 other days of the last 30"
}
],
"summary": "Opposite NQ positions with another trader for 412 s",
"rule": {
"name": "<string>",
"observed": {}
},
"traderIds": [
"<string>"
],
"otherTraders": [
{
"traderId": "<string>",
"traderName": "<string>"
}
],
"pnl": 260.5,
"evidence": {},
"redacted": false,
"supersededAt": "<string>"
}
],
"truncated": true,
"stake": {
"payableProfit": 12400.5,
"fundedAccounts": 2,
"paidBeforeReview": 850,
"payoutPending": "<string>"
}
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid request data",
"code": "BAD_REQUEST"
}{
"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"
}