Get traders linked by a shared device or IP address
Groups of your traders who used the same device or IP address, to spot one person running several trader profiles or several people sharing one account.
Two traders are linked when they were seen on the same device or IP address in the period; links are merged into groups, so A–B and B–C form one group of three. Traders are grouped by login, and only their activity since they first had an account with you counts. Activity at other firms is never included.
Each group has a score from 0 to 100, its strongest link between two traders. A shared device weighs more than a shared IP address, an IP address shared by two traders more than one shared by several, and every extra shared signal raises the score. A device or IP address used by more than maxTradersPerSignal traders is left out and listed in noisySignals.
Results are shared for about 15 minutes and can be up to 30 minutes old; asOf says when the activity was read.
Example
curl "https://api.hyperprop.com/platform/v1/organization/risk/linked-traders?days=30&signal=all" \
-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/linked-traders \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/linked-traders"
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/linked-traders', 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/linked-traders",
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/linked-traders"
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/linked-traders")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/linked-traders")
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",
"redacted": false,
"days": 30,
"signal": "all",
"minTraders": 2,
"maxTradersPerSignal": 10,
"summary": {
"clusters": 4,
"traders": 9,
"accounts": 23,
"fundedAccounts": 3,
"highStrength": 1,
"noisySignals": 2,
"truncated": false
},
"clusters": [
{
"clusterId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"score": 82,
"strength": "high",
"traderCount": 2,
"accountCount": 5,
"fundedAccountCount": 1,
"sharedDevices": 1,
"sharedIps": 2,
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"traders": [
{
"userId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"ownedSince": "2026-09-14T10:02:11.000Z",
"sharedSignals": 3,
"firstSeenAt": "2026-10-05T08:12:44.000Z",
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"status": "in_progress",
"accountType": "sim_funded",
"planId": "7f8d9e0a-1b2c-3d4e-5f60-718293a4b5c6",
"planName": "50K Pro",
"accountSize": 50000
}
]
}
],
"signals": [
{
"type": "device",
"value": "4f1c2b9a7e6d5c3b",
"traderCount": 2,
"traders": [
{
"userId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"firstSeenAt": "2026-10-05T08:12:44.000Z",
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"events": 14
}
]
}
],
"links": [
{
"userIds": [
"2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
],
"score": 82,
"devices": 1,
"ips": 2
}
]
}
],
"noisySignals": [
{
"type": "ip",
"value": "203.0.113.7",
"traderCount": 37
}
]
}
}{
"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"
}{
"success": false,
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"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/linked-traders \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/linked-traders"
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/linked-traders', 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/linked-traders",
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/linked-traders"
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/linked-traders")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/linked-traders")
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",
"redacted": false,
"days": 30,
"signal": "all",
"minTraders": 2,
"maxTradersPerSignal": 10,
"summary": {
"clusters": 4,
"traders": 9,
"accounts": 23,
"fundedAccounts": 3,
"highStrength": 1,
"noisySignals": 2,
"truncated": false
},
"clusters": [
{
"clusterId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"score": 82,
"strength": "high",
"traderCount": 2,
"accountCount": 5,
"fundedAccountCount": 1,
"sharedDevices": 1,
"sharedIps": 2,
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"traders": [
{
"userId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"ownedSince": "2026-09-14T10:02:11.000Z",
"sharedSignals": 3,
"firstSeenAt": "2026-10-05T08:12:44.000Z",
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"status": "in_progress",
"accountType": "sim_funded",
"planId": "7f8d9e0a-1b2c-3d4e-5f60-718293a4b5c6",
"planName": "50K Pro",
"accountSize": 50000
}
]
}
],
"signals": [
{
"type": "device",
"value": "4f1c2b9a7e6d5c3b",
"traderCount": 2,
"traders": [
{
"userId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"firstSeenAt": "2026-10-05T08:12:44.000Z",
"lastSeenAt": "2026-11-02T21:40:03.000Z",
"events": 14
}
]
}
],
"links": [
{
"userIds": [
"2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
],
"score": 82,
"devices": 1,
"ips": 2
}
]
}
],
"noisySignals": [
{
"type": "ip",
"value": "203.0.113.7",
"traderCount": 37
}
]
}
}{
"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"
}{
"success": false,
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"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"
}