Test Accounts

Remove a test account

Removes a registered simulated account. The account stops running on the scheduler’s next sweep. Orders it already produced are untouched and keep the retention every other order has; what is removed is the registration that made the platform simulate it. Callable by a client credential holding the accounts:admin scope, which may remove any organization’s account, and by an organization admin of a configured internal organization, which may remove only its own organization’s accounts.

DELETE

accounts

test

{trading_account_id}

Remove a test account

curl --request DELETE \
  --url https://api.anthid.com/v1/accounts/test/{trading_account_id} \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/accounts/test/{trading_account_id}', 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/{trading_account_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.anthid.com/v1/accounts/test/{trading_account_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "deleted": true,
  "deleted_at": "2026-08-25T18:12:03Z",
  "id": "550e8400-e29b-41d4-a716-446655440111",
  "resource": "test_trading_account"
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Authorizations

Authorization

string

header

required

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

Path Parameters

trading_account_id

string<uuid>

required

Simulated account id

Response

Test account removed. Idempotent: a retry reports the moment of the first deletion.

The body every successful delete returns.

Deletes are idempotent, so a caller that retries one it is unsure landed gets the same 200 as the caller that deleted it. That leaves the caller unable to tell the two apart from the status alone, which is what deleted_at is for: it is the moment the resource was first deleted and does not move on a repeat call.

deleted

boolean

required

Always true. A caller checking one field to confirm the outcome does not have to special-case which endpoint it called.

deleted_at

string<date-time>

required

When the resource was first deleted, not when this call was made.

resource

enum<string>

required

The resource a delete acted on.

Named rather than free text so a caller can branch on it, and so the same vocabulary is available when these deletes start emitting events.

Available options:

trading_account,

test_trading_account,

broker_credential,

oauth_client,

organization,

user,

organization_control,

account_control,

account_risk_control,

account_time_control,

symbol_control,

symbol_risk_control,

symbol_time_control

string | null

Absent for resources keyed by a natural composite key rather than a single identifier, which today is every control in the controls service. The path already identifies those, so nothing is lost by omitting it.

Remove a test account

curl --request DELETE \
  --url https://api.anthid.com/v1/accounts/test/{trading_account_id} \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/accounts/test/{trading_account_id}', 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/{trading_account_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.anthid.com/v1/accounts/test/{trading_account_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "deleted": true,
  "deleted_at": "2026-08-25T18:12:03Z",
  "id": "550e8400-e29b-41d4-a716-446655440111",
  "resource": "test_trading_account"
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Connections

Organizations

Controls

Accounts

Intents

Ledger

Stream

MCP

Remove a test account

Authorizations

Path Parameters

Response