curl --request POST \
--url https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": true
}
'import requests
url = "https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests"
payload = {
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": True
}
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({
instrumentAdmin: 'partner-registrar::1220aa',
instrumentId: 'QUADRILLIONS',
code: 'QUADRILLIONS',
name: 'Quadrillions',
decimals: 10,
logoUrl: 'https://partner.example/quadrillions.png',
category: 'memes',
quoteAsset: 'USD.E',
tickSizeAtoms: '1',
lotSizeAtoms: '1',
minPrice: '0.0000001',
maxPrice: '1',
minQuantity: '1',
maxQuantity: '100000000',
minNotionalAtoms: '10000000000',
listingPriceAtoms: '100000',
makerReferencePriceAtoms: '100000',
noSecurityClaim: true
})
};
fetch('https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests', 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/accounts/{accountId}/listing-requests")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.json(&json!({
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": true
}))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests"
payload := strings.NewReader("{\n \"instrumentAdmin\": \"partner-registrar::1220aa\",\n \"instrumentId\": \"QUADRILLIONS\",\n \"code\": \"QUADRILLIONS\",\n \"name\": \"Quadrillions\",\n \"decimals\": 10,\n \"logoUrl\": \"https://partner.example/quadrillions.png\",\n \"category\": \"memes\",\n \"quoteAsset\": \"USD.E\",\n \"tickSizeAtoms\": \"1\",\n \"lotSizeAtoms\": \"1\",\n \"minPrice\": \"0.0000001\",\n \"maxPrice\": \"1\",\n \"minQuantity\": \"1\",\n \"maxQuantity\": \"100000000\",\n \"minNotionalAtoms\": \"10000000000\",\n \"listingPriceAtoms\": \"100000\",\n \"makerReferencePriceAtoms\": \"100000\",\n \"noSecurityClaim\": true\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://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrumentAdmin\": \"partner-registrar::1220aa\",\n \"instrumentId\": \"QUADRILLIONS\",\n \"code\": \"QUADRILLIONS\",\n \"name\": \"Quadrillions\",\n \"decimals\": 10,\n \"logoUrl\": \"https://partner.example/quadrillions.png\",\n \"category\": \"memes\",\n \"quoteAsset\": \"USD.E\",\n \"tickSizeAtoms\": \"1\",\n \"lotSizeAtoms\": \"1\",\n \"minPrice\": \"0.0000001\",\n \"maxPrice\": \"1\",\n \"minQuantity\": \"1\",\n \"maxQuantity\": \"100000000\",\n \"minNotionalAtoms\": \"10000000000\",\n \"listingPriceAtoms\": \"100000\",\n \"makerReferencePriceAtoms\": \"100000\",\n \"noSecurityClaim\": true\n}")
.asString();{
"id": "<string>",
"requester": {
"kind": "account",
"accountId": "<string>"
},
"marketId": "<string>",
"status": "pending",
"request": {
"instrumentAdmin": "<string>",
"instrumentId": "<string>",
"code": "<string>",
"name": "<string>",
"decimals": 5,
"logoUrl": "<string>",
"category": "crypto",
"quoteAsset": "<string>",
"tickSizeAtoms": "<string>",
"lotSizeAtoms": "<string>",
"minPrice": "<string>",
"maxPrice": "<string>",
"minQuantity": "<string>",
"maxQuantity": "<string>",
"minNotionalAtoms": "<string>",
"listingPriceAtoms": "<string>",
"makerReferencePriceAtoms": "<string>",
"noSecurityClaim": true
},
"partnerLogoUrl": "<string>",
"storedLogoUrl": "<string>",
"timestamp": 1,
"datetime": "<string>",
"decidedAt": "<string>",
"refusalReason": "<string>"
}{
"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"
}
}Send a spot listing request
Sends a spot listing request for a token, for the caller’s own account, and answers 201 with the request in status pending. Edel approves or refuses it later. The body is checked first (400 invalid_request): the instrument ID and the code are plain ASCII letters, digits and a dot; the name is printable text; the instrument admin is a Canton party ID; the logo URL is https, names a host (not an IP address) and has no user, password or port; the body is at most 16 KiB. Then the venue checks, each a 409: the logo URL is not the venue’s default placeholder, since every market has its own logo (listing_request_logo_missing); the quote asset is the venue settlement asset (spot_quote_not_venue_settlement_asset); the instrument admin is an issuer this venue can list, which needs a registrar entry, and for an Edel issuer without a registry URL the instrument’s own record with the same decimals (listing_request_issuer_unknown); the instrument ID and the code name no asset the venue holds, nor the quote or the settlement asset, in any case (listing_request_asset_exists); every price, quantity and notional is written at its scale and fits the engine range, the lot at most the maximum quantity, both quantity limits whole lots (listing_request_limits_out_of_range); the market has a sound shape: positive maximums, each minimum at most its maximum, the tick at most the maximum price, both price limits and the listing price on the tick, the listing price inside the limits (listing_request_market_shape_invalid); the market does not exist yet (listing_request_market_exists); this account has no other pending request for this instrument, its ID without case (listing_request_pending_exists); this account holds fewer than 5 pending requests (listing_request_account_pending_limit). When the venue takes no new request it answers 503 listing_requests_not_accepted; retry later. The live registrar facts (the registrar’s symbol and decimals) are checked when Edel decides the request, not here. Another account’s path answers 403 forbidden. The logo URL is kept on the request as a record only. API keys, including an agent’s key, need the trade scope; each account can send at most 10 requests per hour, valid or not (429). While the partner listings feature is off the route answers 403 feature_disabled with featureFlag partner_listings.
Method and path: POST /v2/accounts/{accountId}/listing-requests
Authentication: DFNS trader bearer required.
Request schema: ListingRequestCreate.
Response schema: ListingRequest.
Error envelope: V2ErrorResponse (contains ExternalRestError external-rest-error/v1 as info).
curl --request POST \
--url https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": true
}
'import requests
url = "https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests"
payload = {
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": True
}
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({
instrumentAdmin: 'partner-registrar::1220aa',
instrumentId: 'QUADRILLIONS',
code: 'QUADRILLIONS',
name: 'Quadrillions',
decimals: 10,
logoUrl: 'https://partner.example/quadrillions.png',
category: 'memes',
quoteAsset: 'USD.E',
tickSizeAtoms: '1',
lotSizeAtoms: '1',
minPrice: '0.0000001',
maxPrice: '1',
minQuantity: '1',
maxQuantity: '100000000',
minNotionalAtoms: '10000000000',
listingPriceAtoms: '100000',
makerReferencePriceAtoms: '100000',
noSecurityClaim: true
})
};
fetch('https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests', 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/accounts/{accountId}/listing-requests")
.bearer_auth(std::env::var("EDEL_API_KEY")?)
.json(&json!({
"instrumentAdmin": "partner-registrar::1220aa",
"instrumentId": "QUADRILLIONS",
"code": "QUADRILLIONS",
"name": "Quadrillions",
"decimals": 10,
"logoUrl": "https://partner.example/quadrillions.png",
"category": "memes",
"quoteAsset": "USD.E",
"tickSizeAtoms": "1",
"lotSizeAtoms": "1",
"minPrice": "0.0000001",
"maxPrice": "1",
"minQuantity": "1",
"maxQuantity": "100000000",
"minNotionalAtoms": "10000000000",
"listingPriceAtoms": "100000",
"makerReferencePriceAtoms": "100000",
"noSecurityClaim": true
}))
.send()?;
println!("{} {}", response.status(), response.text()?);
Ok(())
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests"
payload := strings.NewReader("{\n \"instrumentAdmin\": \"partner-registrar::1220aa\",\n \"instrumentId\": \"QUADRILLIONS\",\n \"code\": \"QUADRILLIONS\",\n \"name\": \"Quadrillions\",\n \"decimals\": 10,\n \"logoUrl\": \"https://partner.example/quadrillions.png\",\n \"category\": \"memes\",\n \"quoteAsset\": \"USD.E\",\n \"tickSizeAtoms\": \"1\",\n \"lotSizeAtoms\": \"1\",\n \"minPrice\": \"0.0000001\",\n \"maxPrice\": \"1\",\n \"minQuantity\": \"1\",\n \"maxQuantity\": \"100000000\",\n \"minNotionalAtoms\": \"10000000000\",\n \"listingPriceAtoms\": \"100000\",\n \"makerReferencePriceAtoms\": \"100000\",\n \"noSecurityClaim\": true\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://testnet.edel-api.xyz/v2/accounts/{accountId}/listing-requests")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrumentAdmin\": \"partner-registrar::1220aa\",\n \"instrumentId\": \"QUADRILLIONS\",\n \"code\": \"QUADRILLIONS\",\n \"name\": \"Quadrillions\",\n \"decimals\": 10,\n \"logoUrl\": \"https://partner.example/quadrillions.png\",\n \"category\": \"memes\",\n \"quoteAsset\": \"USD.E\",\n \"tickSizeAtoms\": \"1\",\n \"lotSizeAtoms\": \"1\",\n \"minPrice\": \"0.0000001\",\n \"maxPrice\": \"1\",\n \"minQuantity\": \"1\",\n \"maxQuantity\": \"100000000\",\n \"minNotionalAtoms\": \"10000000000\",\n \"listingPriceAtoms\": \"100000\",\n \"makerReferencePriceAtoms\": \"100000\",\n \"noSecurityClaim\": true\n}")
.asString();{
"id": "<string>",
"requester": {
"kind": "account",
"accountId": "<string>"
},
"marketId": "<string>",
"status": "pending",
"request": {
"instrumentAdmin": "<string>",
"instrumentId": "<string>",
"code": "<string>",
"name": "<string>",
"decimals": 5,
"logoUrl": "<string>",
"category": "crypto",
"quoteAsset": "<string>",
"tickSizeAtoms": "<string>",
"lotSizeAtoms": "<string>",
"minPrice": "<string>",
"maxPrice": "<string>",
"minQuantity": "<string>",
"maxQuantity": "<string>",
"minNotionalAtoms": "<string>",
"listingPriceAtoms": "<string>",
"makerReferencePriceAtoms": "<string>",
"noSecurityClaim": true
},
"partnerLogoUrl": "<string>",
"storedLogoUrl": "<string>",
"timestamp": 1,
"datetime": "<string>",
"decidedAt": "<string>",
"refusalReason": "<string>"
}{
"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
Created