List the entries and exits of the traders you follow
The latest fills of the traders your organization follows, newest first, on every one of their accounts at your organization. Each fill says whether it opened, added to, reduced, closed or reversed the account’s position in the contract, with the size, price and, for exits, the profit or loss it realized.
- The list comes from trading history, so it is the same whenever you read it. To stay current, read it once and then apply the fills the trading stream sends for
streamAccountIds(see the watchlist read). - Positions are worked out from fills starting 7 days before the range; a fill reducing a position opened before that reads as an entry.
- Page with
nextCursor: pass it asbeforeuntilhasMoreis false. - With
assetClassormarket, only positions and executions in contracts of those markets count.
Pages are shared for a few seconds. About 120 requests per minute per organization.
Example
curl "https://api.hyperprop.com/platform/v1/organization/insights/watchlist/activity?range=24h&limit=50" \
-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/watchlist/activity \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/insights/watchlist/activity"
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/watchlist/activity', 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/watchlist/activity",
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/watchlist/activity"
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/watchlist/activity")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/insights/watchlist/activity")
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": "7d",
"since": "2026-10-27T16:41:07.118Z",
"asOf": "2026-11-03T16:41:07.118Z",
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"traders": 5,
"items": [
{
"id": "3f6c2a1e-9b8d-4c7e-a5f4-1d2c3b4a5e6f",
"time": "2026-11-03T15:58:12.000Z",
"type": "exit",
"action": "close",
"side": "long",
"size": 2,
"sizeUnit": "contracts",
"positionBefore": 2,
"positionAfter": 0,
"price": 21034.25,
"realizedPnl": 412.5,
"copied": false,
"initiatedBy": "trader",
"trader": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"name": "Jane Trader",
"email": "jane@example.com"
},
"account": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "sim_funded",
"planName": "50K Pro"
},
"instrument": {
"contract": "MNQZ6",
"rootSymbol": "MNQ",
"productKey": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"market": "CME",
"assetClass": "future"
}
}
],
"hasMore": true,
"nextCursor": "MjAyNi0xMS0wM1QxNTo1ODoxMi4wMDBafDNmNmMyYTFl"
}
}{
"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/watchlist/activity \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/insights/watchlist/activity"
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/watchlist/activity', 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/watchlist/activity",
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/watchlist/activity"
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/watchlist/activity")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/insights/watchlist/activity")
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": "7d",
"since": "2026-10-27T16:41:07.118Z",
"asOf": "2026-11-03T16:41:07.118Z",
"marketFilter": {
"assetClass": "future",
"markets": [
"CME",
"CBOT"
]
},
"traders": 5,
"items": [
{
"id": "3f6c2a1e-9b8d-4c7e-a5f4-1d2c3b4a5e6f",
"time": "2026-11-03T15:58:12.000Z",
"type": "exit",
"action": "close",
"side": "long",
"size": 2,
"sizeUnit": "contracts",
"positionBefore": 2,
"positionAfter": 0,
"price": 21034.25,
"realizedPnl": 412.5,
"copied": false,
"initiatedBy": "trader",
"trader": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"name": "Jane Trader",
"email": "jane@example.com"
},
"account": {
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"accountType": "sim_funded",
"planName": "50K Pro"
},
"instrument": {
"contract": "MNQZ6",
"rootSymbol": "MNQ",
"productKey": "MNQ",
"name": "Micro E-mini Nasdaq-100",
"productGroup": "equity_index",
"market": "CME",
"assetClass": "future"
}
}
],
"hasMore": true,
"nextCursor": "MjAyNi0xMS0wM1QxNTo1ODoxMi4wMDBafDNmNmMyYTFl"
}
}{
"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"
}