Detect self-hedging, hedging and copy trading
Finds trading patterns among your traders that prop-firm rules usually forbid. Only your organization’s accounts are analyzed, and an account only from when it became its current trader’s.
- Self-hedging: one trader holding opposite positions on the same underlying across their own accounts at the same time, for example long on one evaluation and short on another, or long MNQ against short NQ.
livelists the positions held right now;episodesthe past ones (at least 5 seconds of overlap). - Hedging pairs: two different traders opening opposite positions on the same underlying within
windowSecondsof each other, at leastminOccurrencestimes. - Copy trading: two different traders opening the same position within
windowSeconds, repeatedly: an external trade copier, a signal group or a shared account. Copy trading a trader sets up across their own accounts on the platform is listed underplatformCopyand never reported as a pair.
Micro and full-size contracts on the same underlying are compared (MNQ with NQ, MES with ES, MGC with GC and so on), with sizes in full-size contracts. Each pair and trader has a score from 0 to 100 and a level; a higher score means more of the activity matches, more often, closer in time and size. Scores flag accounts for review; they are not proof.
Moments when very many traders open the same product at once (summary.crowdedMoments, for example a market open) are not used for pairing.
The history is shared for up to 5 minutes per set of parameters; live self-hedges are a few seconds old at most. About 30 requests per minute per organization.
Example
curl "https://api.hyperprop.com/platform/v1/organization/risk/trading-patterns?days=14&windowSeconds=5" \
-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/trading-patterns \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/trading-patterns"
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/trading-patterns', 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/trading-patterns",
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/trading-patterns"
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/trading-patterns")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/trading-patterns")
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",
"asOf": "2026-11-03T14:41:07.118Z",
"params": {
"days": 7,
"windowSeconds": 10,
"minOccurrences": 3,
"since": "2026-10-27T14:41:07.118Z",
"until": "2026-11-03T14:41:07.118Z"
},
"selfHedging": {
"liveAvailable": true,
"liveAsOf": "2026-11-03T14:41:09.002Z",
"live": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"underlying": "NQ",
"hedgedSize": 0.2,
"since": "2026-11-03T14:30:05.000Z",
"sameContract": false,
"legs": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"contract": "MNQZ6",
"side": "long",
"quantity": 2,
"openedAt": "2026-11-03T14:30:00.000Z"
}
]
}
],
"traders": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"episodes": 4,
"hedgedMinutes": 96.5,
"liveNow": true,
"underlyings": [
"ES",
"NQ"
],
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"lastAt": "2026-11-03T14:41:07.118Z",
"score": 82,
"level": "high"
}
],
"episodes": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"underlying": "NQ",
"accountA": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
},
"accountB": {
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"accountId": "9d1e6679-7425-40de-944b-e07fc1f90ae8"
},
"sideA": "long",
"contractsA": [
"MNQZ6"
],
"contractsB": [
"NQZ6"
],
"sameContract": false,
"startedAt": "2026-11-02T14:00:05.000Z",
"endedAt": "2026-11-02T14:30:00.000Z",
"ongoing": false,
"durationSeconds": 1795,
"maxHedgedSize": 0.2
}
],
"episodesTotal": 7
},
"hedgingPairs": [
{
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"underlyings": [
"ES"
],
"occurrences": 9,
"matchedFills": 11,
"activeDays": 4,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.89,
"firstAt": "2026-10-28T13:30:02.000Z",
"lastAt": "2026-11-03T14:05:41.000Z",
"samples": [
{
"atA": "2026-11-03T14:05:39.000Z",
"atB": "2026-11-03T14:05:41.000Z",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"sideA": "buy",
"sideB": "sell",
"secondsApart": 2
}
],
"score": 76,
"level": "high"
}
],
"copyTrading": {
"pairs": [
{
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"underlyings": [
"ES"
],
"occurrences": 9,
"matchedFills": 11,
"activeDays": 4,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.89,
"firstAt": "2026-10-28T13:30:02.000Z",
"lastAt": "2026-11-03T14:05:41.000Z",
"samples": [
{
"atA": "2026-11-03T14:05:39.000Z",
"atB": "2026-11-03T14:05:41.000Z",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"sideA": "buy",
"sideB": "sell",
"secondsApart": 2
}
],
"score": 76,
"level": "high"
}
],
"platformCopy": [
{
"trader": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
},
"groupName": "default",
"leader": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
},
"followers": [
{
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"accountId": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"ratio": 1,
"symbol": "*",
"active": true,
"copiedFills": 14,
"lastCopiedAt": "2026-11-03T14:05:40.000Z"
}
],
"crossOwner": false
}
]
},
"summary": {
"fills": 18402,
"entries": 7311,
"crowdedMoments": 3,
"selfHedgingTraders": 2,
"liveSelfHedges": 1,
"hedgingPairs": 1,
"copyPairs": 3,
"platformCopyGroups": 5
}
}
}{
"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/trading-patterns \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/trading-patterns"
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/trading-patterns', 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/trading-patterns",
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/trading-patterns"
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/trading-patterns")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/trading-patterns")
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",
"asOf": "2026-11-03T14:41:07.118Z",
"params": {
"days": 7,
"windowSeconds": 10,
"minOccurrences": 3,
"since": "2026-10-27T14:41:07.118Z",
"until": "2026-11-03T14:41:07.118Z"
},
"selfHedging": {
"liveAvailable": true,
"liveAsOf": "2026-11-03T14:41:09.002Z",
"live": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"underlying": "NQ",
"hedgedSize": 0.2,
"since": "2026-11-03T14:30:05.000Z",
"sameContract": false,
"legs": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"contract": "MNQZ6",
"side": "long",
"quantity": 2,
"openedAt": "2026-11-03T14:30:00.000Z"
}
]
}
],
"traders": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"episodes": 4,
"hedgedMinutes": 96.5,
"liveNow": true,
"underlyings": [
"ES",
"NQ"
],
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"lastAt": "2026-11-03T14:41:07.118Z",
"score": 82,
"level": "high"
}
],
"episodes": [
{
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"underlying": "NQ",
"accountA": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
},
"accountB": {
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"accountId": "9d1e6679-7425-40de-944b-e07fc1f90ae8"
},
"sideA": "long",
"contractsA": [
"MNQZ6"
],
"contractsB": [
"NQZ6"
],
"sameContract": false,
"startedAt": "2026-11-02T14:00:05.000Z",
"endedAt": "2026-11-02T14:30:00.000Z",
"ongoing": false,
"durationSeconds": 1795,
"maxHedgedSize": 0.2
}
],
"episodesTotal": 7
},
"hedgingPairs": [
{
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"underlyings": [
"ES"
],
"occurrences": 9,
"matchedFills": 11,
"activeDays": 4,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.89,
"firstAt": "2026-10-28T13:30:02.000Z",
"lastAt": "2026-11-03T14:05:41.000Z",
"samples": [
{
"atA": "2026-11-03T14:05:39.000Z",
"atB": "2026-11-03T14:05:41.000Z",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"sideA": "buy",
"sideB": "sell",
"secondsApart": 2
}
],
"score": 76,
"level": "high"
}
],
"copyTrading": {
"pairs": [
{
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
}
],
"entries": 12
},
"underlyings": [
"ES"
],
"occurrences": 9,
"matchedFills": 11,
"activeDays": 4,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.89,
"firstAt": "2026-10-28T13:30:02.000Z",
"lastAt": "2026-11-03T14:05:41.000Z",
"samples": [
{
"atA": "2026-11-03T14:05:39.000Z",
"atB": "2026-11-03T14:05:41.000Z",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"sideA": "buy",
"sideB": "sell",
"secondsApart": 2
}
],
"score": 76,
"level": "high"
}
],
"platformCopy": [
{
"trader": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
},
"groupName": "default",
"leader": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000
},
"followers": [
{
"accountNumber": "ACC-50K-000123",
"accountType": "evaluation",
"status": "in_progress",
"planName": "50K Pro",
"accountSize": 50000,
"accountId": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"ratio": 1,
"symbol": "*",
"active": true,
"copiedFills": 14,
"lastCopiedAt": "2026-11-03T14:05:40.000Z"
}
],
"crossOwner": false
}
]
},
"summary": {
"fills": 18402,
"entries": 7311,
"crowdedMoments": 3,
"selfHedgingTraders": 2,
"liveSelfHedges": 1,
"hedgingPairs": 1,
"copyPairs": 3,
"platformCopyGroups": 5
}
}
}{
"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"
}