Register a simulated test account

POST

accounts

test

curl --request POST \
  --url https://api.anthid.com/v1/accounts/test \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ack_latency_ms": 0,
  "enabled": true,
  "fill_max_ms": 100,
  "fill_min_ms": 5,
  "name": "load-test-01",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "trading_account_id": "550e8400-e29b-41d4-a716-446655440111"
}
'

import requests

url = "https://api.anthid.com/v1/accounts/test"

payload = {
    "ack_latency_ms": 0,
    "enabled": True,
    "fill_max_ms": 100,
    "fill_min_ms": 5,
    "name": "load-test-01",
    "organization_id": "550e8400-e29b-41d4-a716-446655440000",
    "trading_account_id": "550e8400-e29b-41d4-a716-446655440111"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ack_latency_ms: 0,
    enabled: true,
    fill_max_ms: 100,
    fill_min_ms: 5,
    name: 'load-test-01',
    organization_id: '550e8400-e29b-41d4-a716-446655440000',
    trading_account_id: '550e8400-e29b-41d4-a716-446655440111'
  })
};

fetch('https://api.anthid.com/v1/accounts/test', 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.anthid.com/v1/accounts/test",
  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([
    'ack_latency_ms' => 0,
    'enabled' => true,
    'fill_max_ms' => 100,
    'fill_min_ms' => 5,
    'name' => 'load-test-01',
    'organization_id' => '550e8400-e29b-41d4-a716-446655440000',
    'trading_account_id' => '550e8400-e29b-41d4-a716-446655440111'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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.anthid.com/v1/accounts/test"

	payload := strings.NewReader("{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.anthid.com/v1/accounts/test")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/accounts/test")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}"

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

{
  "test_account": {
    "ack_latency_ms": 0,
    "created_at": "2026-08-25T15:07:59Z",
    "created_by": "an_YcKlZQeuLOoB5BcqlOrnV6a0",
    "enabled": true,
    "environment": "paper",
    "fill_max_ms": 100,
    "fill_min_ms": 5,
    "name": "load-test-01",
    "organization_id": "550e8400-e29b-41d4-a716-446655440000",
    "trading_account_id": "550e8400-e29b-41d4-a716-446655440111",
    "updated_at": "2026-08-25T15:07:59Z"
  }
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The account to register. All values shown are placeholders.

Registers a simulated trading account.

Every field is required. A test account is created by an operator with a specific run in mind rather than through a form with sensible defaults, and a half-specified one is more likely to be a mistake than an intention. The simulator's timings are the exception and are optional, because there is a defensible default for each.

enabled

boolean

required

Whether the scheduler should start it.

name

string

required

What to call it. Must not be blank.

organization_id

string<uuid>

required

The tenant this account trades for.

Named explicitly rather than resolved from the caller, because the caller is a service credential and has no organization of its own. This is the one privileged input on the request, and it is why the endpoint is gated on a scope rather than on a tenant role.

trading_account_id

string<uuid>

required

The account id the platform will trade under.

Supplied rather than minted so an operator can register an id a fixture or a script already refers to. Refused if it collides with a real trading account: a test row shadowing a customer's account is the one mistake here that would send their orders to a simulator.

ack_latency_ms

integer<int32> | null

Acknowledgement delay charged to every command, in milliseconds.

Defaults to 10, which is what the clients manager hard-coded before these were configurable. Note this is a per-account rate ceiling as much as a latency: the submitter awaits each command's return before claiming the account's next one, so 10ms caps the account near 100 commands a second. Set it to 0 to measure the platform rather than the simulator.

fill_max_ms

integer<int32> | null

fill_min_ms

integer<int32> | null

Bounds on the simulator's fill delay, in milliseconds. Defaults to 5 and 100. fill_min_ms may not exceed fill_max_ms.

Response

Test account registered

The registered test account, echoed back in full.

The whole row rather than just its id, because the request may have left the simulator's timings out and the operator needs to see which defaults they got without a second call.

test_account

object

required

A simulated trading account, registered by an operator for load testing.

Not a [TradingAccount] with a flag on it, and deliberately so. A trading account is a customer's broker connection: it has a broker, a credential, an append-only event stream behind it and a six year retention obligation. This has none of those. It is a row an operator adds to make the platform trade against an in-process simulator, and removes again afterwards.

Keeping the two types apart is what lets GET /v1/accounts answer one question at a time: without test_accounts=true it lists real accounts and cannot accidentally include one of these, and with it, it lists only these. A shared type carrying a boolean would have made every caller responsible for checking that boolean, and the cost of one forgetting is a customer's orders going to a simulator.

Show child attributes

curl --request POST \
  --url https://api.anthid.com/v1/accounts/test \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ack_latency_ms": 0,
  "enabled": true,
  "fill_max_ms": 100,
  "fill_min_ms": 5,
  "name": "load-test-01",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "trading_account_id": "550e8400-e29b-41d4-a716-446655440111"
}
'

import requests

url = "https://api.anthid.com/v1/accounts/test"

payload = {
    "ack_latency_ms": 0,
    "enabled": True,
    "fill_max_ms": 100,
    "fill_min_ms": 5,
    "name": "load-test-01",
    "organization_id": "550e8400-e29b-41d4-a716-446655440000",
    "trading_account_id": "550e8400-e29b-41d4-a716-446655440111"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ack_latency_ms: 0,
    enabled: true,
    fill_max_ms: 100,
    fill_min_ms: 5,
    name: 'load-test-01',
    organization_id: '550e8400-e29b-41d4-a716-446655440000',
    trading_account_id: '550e8400-e29b-41d4-a716-446655440111'
  })
};

fetch('https://api.anthid.com/v1/accounts/test', 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.anthid.com/v1/accounts/test",
  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([
    'ack_latency_ms' => 0,
    'enabled' => true,
    'fill_max_ms' => 100,
    'fill_min_ms' => 5,
    'name' => 'load-test-01',
    'organization_id' => '550e8400-e29b-41d4-a716-446655440000',
    'trading_account_id' => '550e8400-e29b-41d4-a716-446655440111'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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.anthid.com/v1/accounts/test"

	payload := strings.NewReader("{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.anthid.com/v1/accounts/test")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/accounts/test")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ack_latency_ms\": 0,\n  \"enabled\": true,\n  \"fill_max_ms\": 100,\n  \"fill_min_ms\": 5,\n  \"name\": \"load-test-01\",\n  \"organization_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"trading_account_id\": \"550e8400-e29b-41d4-a716-446655440111\"\n}"

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

{
  "test_account": {
    "ack_latency_ms": 0,
    "created_at": "2026-08-25T15:07:59Z",
    "created_by": "an_YcKlZQeuLOoB5BcqlOrnV6a0",
    "enabled": true,
    "environment": "paper",
    "fill_max_ms": 100,
    "fill_min_ms": 5,
    "name": "load-test-01",
    "organization_id": "550e8400-e29b-41d4-a716-446655440000",
    "trading_account_id": "550e8400-e29b-41d4-a716-446655440111",
    "updated_at": "2026-08-25T15:07:59Z"
  }
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Connections

Organizations

Controls

Accounts

Intents

Ledger

Stream

MCP

Register a simulated test account

Authorizations

Body

Response