Organization

Time Machine — revert an account to a trading day

Time Machine (outage recovery): restore an account to its end-of-day state on the given trading day, in one call — the reverted period stops existing for the trader.

What it does — the reverted period stops existing for the trader:

Closes any open positions and cancels all working orders first (reason: “Trading day reverted by your firm: …”) — no live exposure survives into the reverted world, and the closing fills land inside the voided window so they are erased too
Loads the account’s end-of-day snapshot for tradingDay (or the latest traded day before it — e.g. reverting to a Sunday uses Friday’s close)
Restores currentBalance, highWaterMark, and the daily baseline from that snapshot
Restores the snapshot’s status and violationReason — an account failed during the bad day comes back to life
Voids the daily snapshots after the target day for this account, so consistency checks and daily-stats endpoints no longer see the reverted days (rows are archived, not destroyed)
Voids every order and fill after the reverted day’s close (17:00 America/Chicago): they disappear from the trader’s journal, order history, and trade blotter, and the account’s performance stats (trade count, win rate) are recomputed from the surviving fills. Voided rows are stamped reverted_at and kept in the database for audit — nothing is deleted.
Writes the audit trail (GET /trading-accounts/{accountId}/changes), stamps metadata.last_revert, and fires account.updated (+ status events when the status moved) with trigger: "trading_day_revert"
Pushes the restored state into the live trade engine and notifies the trader’s open terminal (balances, history, and journal update in real time with an explanatory toast)

If the account had never traded on or before the target day (e.g. it was created during the outage day itself), it is restored to its pristine initial state — starting balance, in_progress, entire order history voided. The account keeps existing; reverting never deletes accounts.

Undoable. Every executed revert returns a batchId and appears in the Time Machine ledger (GET /revert-batches). Nothing a revert touches is destroyed, so if you reverted by mistake, POST /revert-batches/{batchId}/undo puts the account back exactly where it was — as long as the trader hasn’t produced new activity since (see that endpoint for the rules).

Notes:

preview: true never touches positions — the flatten only happens on execute.
Consistency: reverted days are removed from the day list automatically (their snapshots are voided).

Recommended flow (calendar UI): call with "preview": true first to show the operator what will happen (restored balance, status transition, orders voided), then call again without preview to execute.

Error codes:

Code	Status	Meaning
`ACCOUNT_NOT_FOUND`	404	Account does not exist or belongs to a different organization
`SNAPSHOT_FETCH_ERROR`	500	Could not read the account’s daily snapshots — retry
`SNAPSHOT_DELETE_ERROR`	500	Failed to void post-revert snapshots — retry (idempotent)
`REVERT_UPDATE_ERROR`	500	Failed to write the restored account state — retry (idempotent)

The revert is safe to retry: every step is idempotent (already-voided rows keep their original stamp, and the state write is absolute).

Example — preview, then execute:

# 1. Dry run — nothing changes
curl -X POST ".../v1/organization/accounts/7c9e6679-7425-40de-944b-e07fc1f90ae7/revert-trading-day" \
  -H "X-API-Key: hp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "tradingDay": "2026-07-07", "reason": "CME data feed outage on 2026-07-08", "preview": true }'

# 2. Execute
curl -X POST ".../v1/organization/accounts/7c9e6679-7425-40de-944b-e07fc1f90ae7/revert-trading-day" \
  -H "X-API-Key: hp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "tradingDay": "2026-07-07", "reason": "CME data feed outage on 2026-07-08" }'

POST

organization

accounts

{accountId}

revert-trading-day

Time Machine — revert an account to a trading day

curl --request POST \
  --url https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tradingDay": "2026-07-07",
  "reason": "CME data feed outage on 2026-07-08",
  "preview": true
}
'

import requests

url = "https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day"

payload = {
    "tradingDay": "2026-07-07",
    "reason": "CME data feed outage on 2026-07-08",
    "preview": True
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tradingDay: '2026-07-07',
    reason: 'CME data feed outage on 2026-07-08',
    preview: true
  })
};

fetch('https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day', 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/accounts/{accountId}/revert-trading-day",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tradingDay' => '2026-07-07',
    'reason' => 'CME data feed outage on 2026-07-08',
    'preview' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day"

	payload := strings.NewReader("{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Trading day reverted successfully",
  "data": {
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountNumber": "ACC-7845KXPQ",
    "revertedTo": "2026-07-07",
    "balanceBefore": 48750,
    "balanceAfter": 51250,
    "statusBefore": "failed",
    "statusAfter": "in_progress",
    "snapshotsDeleted": 1,
    "ordersVoided": 14,
    "positionsClosed": 1,
    "ordersCancelled": 2,
    "batchId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "preview": false
  }
}

{
  "success": false,
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

{
  "success": false,
  "statusCode": 403,
  "error": "Forbidden",
  "message": "Access denied",
  "code": "FORBIDDEN"
}

{
  "success": false,
  "code": "ACCOUNT_NOT_FOUND",
  "message": "Account not found in your organization"
}

{
  "success": false,
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "code": "INTERNAL_ERROR"
}

Authorizations

Authorization

string

header

required

JWT Bearer token for user session auth. Format: "Bearer {token}". Used by User and Organization endpoints.

Path Parameters

accountId

string

required

Trading account to revert

Body

application/json

tradingDay

string

required

Chicago trading day (YYYY-MM-DD) to revert TO. The account is restored to its end-of-day state on this day (or the latest traded day before it).

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-07-07"

reason

string

required

Why the revert happened — stored in the audit trail, account metadata, and webhook events.

Minimum string length: 3

Example:

"CME data feed outage on 2026-07-08"

preview

boolean

default:false

Dry run: return exactly what the revert WOULD do (target day, balances, status transition, snapshots removed, orders voided) without changing anything. Perfect for an "are you sure?" confirmation screen.

Example:

true

Response

Account reverted

success

boolean

Example:

true

message

string

Example:

"Trading day reverted successfully"

data

object

Show child attributes

Example:

{
  "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "accountNumber": "ACC-7845KXPQ",
  "revertedTo": "2026-07-07",
  "balanceBefore": 48750,
  "balanceAfter": 51250,
  "statusBefore": "failed",
  "statusAfter": "in_progress",
  "snapshotsDeleted": 1,
  "ordersVoided": 14,
  "positionsClosed": 1,
  "ordersCancelled": 2,
  "batchId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "preview": false
}

⌘I

Time Machine — revert an account to a trading day

curl --request POST \
  --url https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tradingDay": "2026-07-07",
  "reason": "CME data feed outage on 2026-07-08",
  "preview": true
}
'

import requests

url = "https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day"

payload = {
    "tradingDay": "2026-07-07",
    "reason": "CME data feed outage on 2026-07-08",
    "preview": True
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tradingDay: '2026-07-07',
    reason: 'CME data feed outage on 2026-07-08',
    preview: true
  })
};

fetch('https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day', 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/accounts/{accountId}/revert-trading-day",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tradingDay' => '2026-07-07',
    'reason' => 'CME data feed outage on 2026-07-08',
    'preview' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day"

	payload := strings.NewReader("{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperprop.com/platform/v1/organization/accounts/{accountId}/revert-trading-day")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tradingDay\": \"2026-07-07\",\n  \"reason\": \"CME data feed outage on 2026-07-08\",\n  \"preview\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Trading day reverted successfully",
  "data": {
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountNumber": "ACC-7845KXPQ",
    "revertedTo": "2026-07-07",
    "balanceBefore": 48750,
    "balanceAfter": 51250,
    "statusBefore": "failed",
    "statusAfter": "in_progress",
    "snapshotsDeleted": 1,
    "ordersVoided": 14,
    "positionsClosed": 1,
    "ordersCancelled": 2,
    "batchId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "preview": false
  }
}

{
  "success": false,
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

{
  "success": false,
  "statusCode": 403,
  "error": "Forbidden",
  "message": "Access denied",
  "code": "FORBIDDEN"
}

{
  "success": false,
  "code": "ACCOUNT_NOT_FOUND",
  "message": "Account not found in your organization"
}

{
  "success": false,
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "code": "INTERNAL_ERROR"
}

Platform API

Trade API

Market Data API

Time Machine — revert an account to a trading day

Authorizations

Path Parameters

Body

Response