curl --request POST \
--url https://testnet.edel-api.xyz/v2/spot/twap-orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}
'import requests
url = "https://testnet.edel-api.xyz/v2/spot/twap-orders"
payload = {
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}
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: 'NVDAe/USD.E', side: 'buy', amount: 1, duration: 600000})
};
fetch('https://testnet.edel-api.xyz/v2/spot/twap-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/spot/twap-orders")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.header("Idempotency-Key", "<Idempotency-Key>")
.json(&json!({
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/spot/twap-orders"
payload := strings.NewReader("{\n \"symbol\": \"NVDAe/USD.E\",\n \"side\": \"buy\",\n \"amount\": 1,\n \"duration\": 600000\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/spot/twap-orders")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"symbol\": \"NVDAe/USD.E\",\n \"side\": \"buy\",\n \"amount\": 1,\n \"duration\": 600000\n}")
.asString();{
"id": "<string>",
"clientOrderId": "<string>",
"symbol": "<string>",
"timestamp": 1,
"datetime": "<string>",
"lastTradeTimestamp": null,
"lastUpdateTimestamp": 1,
"status": "open",
"side": "buy",
"type": "twap",
"price": 123,
"amount": 123,
"filled": 1,
"remaining": 1,
"cost": 1,
"postOnly": false,
"reduceOnly": false,
"trades": [
{
"id": "<string>",
"order": "<string>",
"symbol": "<string>",
"timestamp": 1,
"datetime": "<string>",
"side": "buy",
"takerOrMaker": "maker",
"price": 123,
"amount": 1,
"fee": {
"cost": 123,
"currency": "<string>"
},
"info": {
"tradeId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"role": "maker",
"feePaidAtoms": "<string>",
"feePaid": "<string>",
"feeRole": "maker",
"side": "buy",
"priceAtoms": "<string>",
"price": "<string>",
"sizeAtoms": "<string>",
"size": "<string>",
"orderId": "<string>",
"counterpartyOrderId": "<string>",
"occurredAtEpochMs": 1,
"lastSequence": 1,
"realizedPnlAtoms": "<string>",
"realizedPnl": "<string>",
"origin": "liquidation"
},
"type": "<string>",
"cost": 123
}
],
"fee": null,
"info": {
"orderId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"productType": "spot",
"parentKind": "twap",
"parentState": "pending",
"parentReason": "<string>",
"slicesSent": 1,
"slicesTotal": 123,
"nextSliceAt": 1,
"durationMs": 123,
"randomize": true,
"amountAtoms": "<string>",
"filledBaseAtoms": "<string>",
"filledQuoteAtoms": "<string>",
"limitPriceAtoms": "<string>"
},
"average": 123
}{
"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 a TWAP order (spot)
Spot markets only. Send a spot symbol such as NVDAe/USDCx. Spot is live on the Development environment and is rolling out to TestNet.
CreateTwapOrder(symbol, side, amount, duration, params) on a spot market. Edel sends one market child order each 30000 milliseconds on the account until the amount is done; the children are ordinary orders and fills of the account. duration is in MILLISECONDS, from 300000 (5 minutes) to 604800000 (7 days), and the number of slices is duration divided by 30000, rounded down. params: randomize (each slice size changes by up to 20 percent), price (the limit price: no slice buys above it or sells below it), clientOrderId, expiresAfter (epoch milliseconds; a create that arrives later is refused 400 invalid_request) and reduceOnly (perpetual only; true on a spot market is refused 409 reduce_only_not_supported). The answer is 200 with the parent as a Order: type twap, status open, info.parentState pending, info.slicesTotal and info.nextSliceAt. Nothing is locked at create: each child locks its own funds. Refusals, each by name in code: 403 feature_disabled with info.featureFlag orders.twap while TWAP orders are off (503 with featureFlag spot while spot is off); 400 twap_duration_out_of_range; 400 twap_size_below_minimum when the total is below 100 units of the quote asset at the last price (or the limit price), or one slice is below the market’s minimum order value; 400 twap_slice_below_lot when one slice is below the market lot or minimum quantity; 400 invalid_request for an amount or a limit price that the market scale cannot write as a plain decimal (too many places, or 1e21 and more) or that is above the market maximum quantity or maximum price; 409 invalid_quantity or invalid_price for an amount off the lot or a limit price off the tick; 409 market_order_unavailable when the market never traded and no limit price is given; 409 parent_order_limit_reached when the account already holds 5 active TWAP and Chase orders; 409 insufficient_balance when the free balance does not cover the whole order now (the quote asset for a buy, the base asset for a sell); 409 unsupported_order_command on a perpetual market. A create repeated with the same Idempotency-Key, or the same clientOrderId and the same order, answers the first parent; the same clientOrderId with another order is 409 duplicate_order_id. Read the parent with fetchOrder and cancel it with cancelOrder and params.twap.
curl --request POST \
--url https://testnet.edel-api.xyz/v2/spot/twap-orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}
'import requests
url = "https://testnet.edel-api.xyz/v2/spot/twap-orders"
payload = {
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}
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: 'NVDAe/USD.E', side: 'buy', amount: 1, duration: 600000})
};
fetch('https://testnet.edel-api.xyz/v2/spot/twap-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/spot/twap-orders")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.header("Idempotency-Key", "<Idempotency-Key>")
.json(&json!({
"symbol": "NVDAe/USD.E",
"side": "buy",
"amount": 1,
"duration": 600000
}))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/spot/twap-orders"
payload := strings.NewReader("{\n \"symbol\": \"NVDAe/USD.E\",\n \"side\": \"buy\",\n \"amount\": 1,\n \"duration\": 600000\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/spot/twap-orders")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"symbol\": \"NVDAe/USD.E\",\n \"side\": \"buy\",\n \"amount\": 1,\n \"duration\": 600000\n}")
.asString();{
"id": "<string>",
"clientOrderId": "<string>",
"symbol": "<string>",
"timestamp": 1,
"datetime": "<string>",
"lastTradeTimestamp": null,
"lastUpdateTimestamp": 1,
"status": "open",
"side": "buy",
"type": "twap",
"price": 123,
"amount": 123,
"filled": 1,
"remaining": 1,
"cost": 1,
"postOnly": false,
"reduceOnly": false,
"trades": [
{
"id": "<string>",
"order": "<string>",
"symbol": "<string>",
"timestamp": 1,
"datetime": "<string>",
"side": "buy",
"takerOrMaker": "maker",
"price": 123,
"amount": 1,
"fee": {
"cost": 123,
"currency": "<string>"
},
"info": {
"tradeId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"role": "maker",
"feePaidAtoms": "<string>",
"feePaid": "<string>",
"feeRole": "maker",
"side": "buy",
"priceAtoms": "<string>",
"price": "<string>",
"sizeAtoms": "<string>",
"size": "<string>",
"orderId": "<string>",
"counterpartyOrderId": "<string>",
"occurredAtEpochMs": 1,
"lastSequence": 1,
"realizedPnlAtoms": "<string>",
"realizedPnl": "<string>",
"origin": "liquidation"
},
"type": "<string>",
"cost": 123
}
],
"fee": null,
"info": {
"orderId": "<string>",
"accountId": "<string>",
"marketId": "<string>",
"productType": "spot",
"parentKind": "twap",
"parentState": "pending",
"parentReason": "<string>",
"slicesSent": 1,
"slicesTotal": 123,
"nextSliceAt": 1,
"durationMs": 123,
"randomize": true,
"amountAtoms": "<string>",
"filledBaseAtoms": "<string>",
"filledQuoteAtoms": "<string>",
"limitPriceAtoms": "<string>"
},
"average": 123
}{
"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
Success
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})$