curl --request POST \
--url https://testnet.edel-api.xyz/v2/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
[
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": false
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": false
}
}
]
'import requests
url = "https://testnet.edel-api.xyz/v2/orders"
payload = [
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": False
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": False
}
}
]
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify([
{
symbol: 'BTC/USDCx:USDCx',
type: 'limit',
side: 'buy',
amount: 0.001,
price: 65000,
params: {clientOrderId: 'client-example-1', postOnly: false}
},
{
symbol: 'BTC/USDCx:USDCx',
type: 'limit',
side: 'sell',
amount: 0.001,
price: 66000,
params: {clientOrderId: 'client-example-2', postOnly: false}
}
])
};
fetch('https://testnet.edel-api.xyz/v2/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));use reqwest::blocking::Client;
use serde_json::json;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let response = Client::new()
.post("https://testnet.edel-api.xyz/v2/orders")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.header("Idempotency-Key", "<Idempotency-Key>")
.json(&json!([
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": false
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": false
}
}
]))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/orders"
payload := strings.NewReader("[\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"buy\",\n \"amount\": 0.001,\n \"price\": 65000,\n \"params\": {\n \"clientOrderId\": \"client-example-1\",\n \"postOnly\": false\n }\n },\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"sell\",\n \"amount\": 0.001,\n \"price\": 66000,\n \"params\": {\n \"clientOrderId\": \"client-example-2\",\n \"postOnly\": false\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://testnet.edel-api.xyz/v2/orders")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"buy\",\n \"amount\": 0.001,\n \"price\": 65000,\n \"params\": {\n \"clientOrderId\": \"client-example-1\",\n \"postOnly\": false\n }\n },\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"sell\",\n \"amount\": 0.001,\n \"price\": 66000,\n \"params\": {\n \"clientOrderId\": \"client-example-2\",\n \"postOnly\": false\n }\n }\n]")
.asString();[
{
"id": "<string>",
"symbol": "<string>",
"status": "open",
"info": {
"index": 1,
"accepted": true,
"orderId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"status": "open",
"lastSequence": 1,
"idempotencyKey": "<string>",
"postOnly": true,
"icebergQty": 123,
"side": "buy",
"orderType": "limit",
"price": "<string>",
"priceAtoms": "<string>",
"quantityAtoms": "<string>",
"filledQuantityAtoms": "<string>",
"productType": "spot",
"lockAsset": "<string>",
"lockedAtoms": "<string>",
"remainingQuantityAtoms": "<string>",
"createdAtEpochMs": 1,
"filledQuoteAtoms": "<string>"
},
"clientOrderId": null,
"timestamp": null,
"datetime": null,
"lastUpdateTimestamp": 1,
"side": null,
"type": null,
"timeInForce": "GTC",
"price": null,
"amount": null,
"filled": null,
"remaining": null,
"reduceOnly": null,
"postOnly": null,
"lastTradeTimestamp": null,
"cost": null,
"trades": [],
"fee": null
}
]{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}Create LIMIT orders
Works for perpetual and spot markets, for example the spot symbol NVDAe/USDCx. Spot is built and in internal testing; it is not open on TestNet or MainNet yet.
Translates 1 to 32 OrderRequest entries into the existing bounded LIMIT batch handler. It returns one ordered result per input; accepted siblings remain committed when another entry is refused. An entry may name timeInForce GTC, how every limit order rests, or PO, which places it post-only. Any other value, or PO with postOnly false, is refused with HTTP 400 and no entry is placed.
Method and path: POST /v2/orders
Authentication: DFNS trader bearer required.
Request schema: V2CreateOrdersRequest.
Response schema: V2CreateOrdersResponse.
Error envelope: V2ErrorResponse (contains ExternalRestError external-rest-error/v1 as info).
curl --request POST \
--url https://testnet.edel-api.xyz/v2/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
[
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": false
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": false
}
}
]
'import requests
url = "https://testnet.edel-api.xyz/v2/orders"
payload = [
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": False
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": False
}
}
]
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify([
{
symbol: 'BTC/USDCx:USDCx',
type: 'limit',
side: 'buy',
amount: 0.001,
price: 65000,
params: {clientOrderId: 'client-example-1', postOnly: false}
},
{
symbol: 'BTC/USDCx:USDCx',
type: 'limit',
side: 'sell',
amount: 0.001,
price: 66000,
params: {clientOrderId: 'client-example-2', postOnly: false}
}
])
};
fetch('https://testnet.edel-api.xyz/v2/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));use reqwest::blocking::Client;
use serde_json::json;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let response = Client::new()
.post("https://testnet.edel-api.xyz/v2/orders")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.header("Idempotency-Key", "<Idempotency-Key>")
.json(&json!([
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "buy",
"amount": 0.001,
"price": 65000,
"params": {
"clientOrderId": "client-example-1",
"postOnly": false
}
},
{
"symbol": "BTC/USDCx:USDCx",
"type": "limit",
"side": "sell",
"amount": 0.001,
"price": 66000,
"params": {
"clientOrderId": "client-example-2",
"postOnly": false
}
}
]))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/orders"
payload := strings.NewReader("[\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"buy\",\n \"amount\": 0.001,\n \"price\": 65000,\n \"params\": {\n \"clientOrderId\": \"client-example-1\",\n \"postOnly\": false\n }\n },\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"sell\",\n \"amount\": 0.001,\n \"price\": 66000,\n \"params\": {\n \"clientOrderId\": \"client-example-2\",\n \"postOnly\": false\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://testnet.edel-api.xyz/v2/orders")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"buy\",\n \"amount\": 0.001,\n \"price\": 65000,\n \"params\": {\n \"clientOrderId\": \"client-example-1\",\n \"postOnly\": false\n }\n },\n {\n \"symbol\": \"BTC/USDCx:USDCx\",\n \"type\": \"limit\",\n \"side\": \"sell\",\n \"amount\": 0.001,\n \"price\": 66000,\n \"params\": {\n \"clientOrderId\": \"client-example-2\",\n \"postOnly\": false\n }\n }\n]")
.asString();[
{
"id": "<string>",
"symbol": "<string>",
"status": "open",
"info": {
"index": 1,
"accepted": true,
"orderId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"status": "open",
"lastSequence": 1,
"idempotencyKey": "<string>",
"postOnly": true,
"icebergQty": 123,
"side": "buy",
"orderType": "limit",
"price": "<string>",
"priceAtoms": "<string>",
"quantityAtoms": "<string>",
"filledQuantityAtoms": "<string>",
"productType": "spot",
"lockAsset": "<string>",
"lockedAtoms": "<string>",
"remainingQuantityAtoms": "<string>",
"createdAtEpochMs": 1,
"filledQuoteAtoms": "<string>"
},
"clientOrderId": null,
"timestamp": null,
"datetime": null,
"lastUpdateTimestamp": 1,
"side": null,
"type": null,
"timeInForce": "GTC",
"price": null,
"amount": null,
"filled": null,
"remaining": null,
"reduceOnly": null,
"postOnly": null,
"lastTradeTimestamp": null,
"cost": null,
"trades": [],
"fee": null
}
]{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}{
"name": "AccountNotEnabled",
"message": "<string>",
"code": "promo_code_unknown",
"retryable": true,
"timestamp": 1,
"datetime": "<string>",
"info": {
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "promo_code_unknown",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"featureFlag": "<string>",
"orderOutcome": "not_submitted",
"clientOrderIds": [
"<string>"
],
"reconciliation": "<string>",
"realtimeTicketFailure": "invalid",
"apiKeyRejection": "malformed",
"agentRefusal": "agents_not_admitted_in_environment",
"rejectionGuard": "custodial_signer_environment_not_service_held",
"withdrawalFailure": "spot_disabled",
"feeShareAcceptRefusal": "challenge_missing",
"dependency": "dfns",
"squidRouteRefusal": "route_not_found",
"positionSnapshotRefusal": "position_projection_behind_live",
"setupKeyRefusal": "setup_key_refused"
}
}Authorizations
The authorization field takes the session bearer returned by sign-in, or an API key where the route allows keys. Paste the token itself into the authorization field. When invitation-only access is enabled, private operations require the account's sign-in email to be invited. Sign-in can complete without an invitation, but private HTTP, MCP and FIX operations refuse with access_not_allowlisted (HTTP 403): "Private access is limited to invited accounts. Contact support to request access." Public market data remains available. Invitation changes apply to the next private operation, including existing FIX sessions. Do not retry until support confirms access.
Body
Response
Accepted for processing
1 - 32 elements- Option 1
- Option 2
1 to 256 ASCII letters, digits, periods, underscores, colons or hyphens. Canonical bot identifiers also allow the fixed bot-order/v1: prefix followed by an optional sha256: marker and 64 lowercase hexadecimal digits.
1 - 256^(?:[A-Za-z0-9._:-]+|bot-order\/v1:(?:sha256:)?[a-f0-9]{64})$