Skip to content

Create many multi legs orders#

POST https://api.pro.anboto.xyz/api/v2/trading/order/createMany/multilegs

Process a set of new order request and returns a summary for each order, the orders are not linked during execution and this endpoint is for convenience only ApiKeyAuth required.

Body params#

orders array[CreateMultiLegsParentOrderRequest] required

Headers#

Header
X-API-KEY string required
X-TIMESTAMP int64 ms required
X-SIGN string required
X-RECV-WINDOW int, default 5000

Responses#
201 Order processed.
401 Unauthorized, Invalid Signature
429 Rate limit exceeded, retry later

Response fields — OrderSummaryList#

orders array[OrderSummary] required
The list of order summaries for separate orders.
orders[].order_id integer
The Anboto assigned order identifier
orders[].client_order_id string
A custom string to identify the order
Example: ABC-12345^12-10-23
orders[].status enum
The order status — PENDING_NEW, ACCEPTED, REJECTED, PARTIALLY_FILLED, FILLED, PENDING_CANCEL, CANCELLED, PENDING_PAUSE, … (12 values)
orders[].created_at date-time required
The time in UTC when the order was created
Example: 2024-01-22T22:05:00Z
orders[].message string
Any additional information, usually if the order was rejected
orders[].error_code enum
The error code used to describe why an order was rejected. — OTHER, QUANTITY_EXCEED, AUTHENTICATION_ERROR, INSUFFICIENT_FUNDS, RATE_LIMIT_EXCEEDED, DDOS_PROTECTION, EXCHANGE_NOT_AVAILABLE, NETWORK_ERROR, … (34 values)
Example: INVALID_ORDER
body='{
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
}'

curl -X POST "$BASE/api/v2/trading/order/createMany/multilegs" \
  -H "X-API-KEY: $API_KEY" -H "X-TIMESTAMP: $ts" \
  -H "X-SIGN: $sign" \
  -H "Content-Type: application/json" -d "$body"

payload = {
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
}

r = requests.post(f"{BASE}/api/v2/trading/order/createMany/multilegs",
    data=json.dumps(payload)
    headers=signed_headers(payload))
print(r.json())

let payload = serde_json::json!({
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
});

let resp = client
    .post(format!("{BASE}/api/v2/trading/order/createMany/multilegs"))
    .headers(signed_headers(&payload))
    .json(&payload)
    .send()?;
println!("{}", resp.text()?);

payload := map[string]any{
    "orders": []any{
        map[string]any{
            "client_order_id": "ABC-12345^12-10-23",
            "subaccount": "string",
            "algo": "PAIR",
            "legs": []any{
                map[string]any{},
            },
            "start_time": "2024-01-22T22:05:00Z",
            "end_time": "2024-04-22T22:05:00Z",
            "params": map[string]any{},
        },
    },
}
body, _ := json.Marshal(payload)

req, _ := http.NewRequest("POST", BASE+"/api/v2/trading/order/createMany/multilegs", bytes.NewReader(body))
for k, v := range signedHeaders(string(body)) {
    req.Header.Set(k, v)
}
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
io.Copy(os.Stdout, resp.Body)

String jsonBody = mapper.writeValueAsString(payload);
HttpResponse<String> resp = client.send(
    signedPost("/api/v2/trading/order/createMany/multilegs", jsonBody),
    HttpResponse.BodyHandlers.ofString());

const payload: CreateManyMultiLegsParentOrdersRequest = {
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
};

const res = await fetch(`${BASE}/api/v2/trading/order/createMany/multilegs`, {
  method: "POST",
  headers: signedHeaders(payload),
  body: JSON.stringify(payload),
});
const data: OrderSummaryList = await res.json();

val jsonBody = mapper.writeValueAsString(payload)
val request = signedPost("/api/v2/trading/order/createMany/multilegs", jsonBody)
val response = client.send(request, HttpResponse.BodyHandlers.ofString())
println(response.body())

std::string body = R"({
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
})";

cpr::Response r = cpr::Post(
    cpr::Url{BASE + "/api/v2/trading/order/createMany/multilegs"},
    signedHeaders(body),
    cpr::Header{{"Content-Type", "application/json"}},
    cpr::Body{body});
std::cout << r.text << std::endl;

const payload = {
  "orders": [
    {
      "client_order_id": "ABC-12345^12-10-23",
      "subaccount": "string",
      "algo": "PAIR",
      "legs": [
        {}
      ],
      "start_time": "2024-01-22T22:05:00Z",
      "end_time": "2024-04-22T22:05:00Z",
      "params": {}
    }
  ]
};

const res = await fetch(`${BASE}/api/v2/trading/order/createMany/multilegs`, {
  method: "POST",
  headers: signedHeaders(payload),
  body: JSON.stringify(payload),
});
console.log(await res.json());

Response 201

{
  "orders": [
    {
      "order_id": 0,
      "client_order_id": "ABC-12345^12-10-23",
      "status": "PENDING_NEW",
      "created_at": "2024-01-22T22:05:00Z",
      "message": "string",
      "error_code": "OTHER"
    }
  ]
}