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>

"<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 paper account. Timing fields are optional; other fields are required.

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

Organization the account trades for. Internal organization admins must name their own organization.

trading_account_id

string<uuid>

required

Caller-supplied account ID. Must not already identify a real or simulated account.

ack_latency_ms

integer<int32> | null

Nonnegative acknowledgement delay in milliseconds. Defaults to 10.

fill_max_ms

integer<int32> | null

Nonnegative maximum fill delay in milliseconds. Defaults to 100.

fill_min_ms

integer<int32> | null

Nonnegative minimum fill delay in milliseconds. Defaults to 5 and must 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>

"<string>"

Connections

Organizations

Controls

Accounts

Intents

Ledger

Instruments

Stream

MCP

Billing

Register a simulated test account

Authorizations

Body

Response