Get a payout forecast for the next 7 and 30 days
How much you can expect to pay out in the next 7 and the next 30 days, with the figures it is built from.
Method
The basis is the last 56 trading days. For each funded account we add up its profit on the days it closed in profit (fundedProfit), and compare that with the payouts executed over the same days (conversionPct). The forecast (byProfit) is that share of the funded accounts’ average profitable-day profit, times the trading days ahead. byRunRate is the average payout per calendar day over the last 28 days, times the days ahead; low and high are the two methods’ range. Exchange holidays are not taken out.
openProfitOwed is what active funded accounts hold above their starting balance now: profit that can still be requested.
Trading days follow the CME session (a day starts at 17:00 America/Chicago). Test accounts are excluded. Results are recomputed at most every 15 minutes, so they can be up to 30 minutes old.
Example
curl "https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast" \
-H "X-API-Key: hp_live_your_key_here"
Permissions: requires view access to “Analytics”.
Access: read-only and full-access API keys. Dashboard members need view access to Analytics & audit log.
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast"
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/payout-forecast', 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/payout-forecast",
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/payout-forecast"
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/payout-forecast")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast")
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",
"generatedAt": "2026-11-14T08:00:00.000Z",
"currency": "USD",
"asOfTradingDay": "2026-11-14",
"confidence": "ok",
"horizons": [
{
"days": 7,
"tradingDays": 5,
"until": "2026-11-20",
"expected": 2310400.5,
"low": 2310400.5,
"high": 2955170,
"byProfit": 2310400.5,
"byRunRate": 2955170
}
],
"openProfitOwed": 2104596.12,
"fundedInProgress": 1728,
"basis": {
"from": "2026-09-19",
"to": "2026-11-13",
"tradingDays": 40,
"fundedProfit": 26712613,
"fundedNetProfit": -7320707,
"payouts": 16548955,
"payoutCount": 22550,
"conversionPct": 61.95,
"profitPerTradingDay": 667815.33,
"payoutsLast28Days": 8272480,
"payoutCountLast28Days": 11402
},
"weeks": [
{
"from": "2026-11-07",
"to": "2026-11-13",
"payouts": 2120000,
"payoutCount": 2900,
"fundedProfit": 3400000,
"fundedNetProfit": -900000
}
]
}
}{
"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"
}{
"success": false,
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to build the payout forecast",
"code": "FORECAST_ERROR"
}{
"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
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast"
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/payout-forecast', 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/payout-forecast",
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/payout-forecast"
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/payout-forecast")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/payout-forecast")
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",
"generatedAt": "2026-11-14T08:00:00.000Z",
"currency": "USD",
"asOfTradingDay": "2026-11-14",
"confidence": "ok",
"horizons": [
{
"days": 7,
"tradingDays": 5,
"until": "2026-11-20",
"expected": 2310400.5,
"low": 2310400.5,
"high": 2955170,
"byProfit": 2310400.5,
"byRunRate": 2955170
}
],
"openProfitOwed": 2104596.12,
"fundedInProgress": 1728,
"basis": {
"from": "2026-09-19",
"to": "2026-11-13",
"tradingDays": 40,
"fundedProfit": 26712613,
"fundedNetProfit": -7320707,
"payouts": 16548955,
"payoutCount": 22550,
"conversionPct": 61.95,
"profitPerTradingDay": 667815.33,
"payoutsLast28Days": 8272480,
"payoutCountLast28Days": 11402
},
"weeks": [
{
"from": "2026-11-07",
"to": "2026-11-13",
"payouts": 2120000,
"payoutCount": 2900,
"fundedProfit": 3400000,
"fundedNetProfit": -900000
}
]
}
}{
"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"
}{
"success": false,
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to build the payout forecast",
"code": "FORECAST_ERROR"
}{
"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"
}