---
title: "Batch Amend Orders"
method: POST
path: "/api/v1/order/amend-batch"
tags: ["Trade"]
---

# Batch Amend Orders

`POST /api/v1/order/amend-batch`

Amend multiple existing orders in a single request

## Request body

- BatchAmendOrdersRequest — Batch amend order request. You can amend unfilled or partially filled orders. TODO: Maximum 20 orders per request
  - `await_outcome` boolean — If true, gateway waits up to a server-defined timeout (currently 3s) for final engine outcomes and maps them into `exit_info`. If false (default), `exit_info` reports edge outcomes (validation + publish ack).
  - `request` AmendOrderRequest[], required
    - `order_id` string, uuid
    - `order_iv` integer, nullable
    - `order_link_id` string
    - `price` string, required
    - `qty` string, required
    - `sub_account_address` string, required
    - `symbol` string, required
    - `tpsl` TpSl
      - `mode` 'Full' | 'Partial', required
      - `stop_loss` union
        - object
          - `market` object, required
            - `trigger_by` 'LastPrice' | 'IndexPrice' | 'MarkPrice', required
            - `trigger_price` string, required
        - object
          - `limit` object, required
            - `limit_price` string, required
            - `trigger_by` 'LastPrice' | 'IndexPrice' | 'MarkPrice', required
            - `trigger_price` string, required
      - `take_profit` union
        - object
          - `market` object, required
            - `trigger_by` 'LastPrice' | 'IndexPrice' | 'MarkPrice', required
            - `trigger_price` string, required
        - object
          - `limit` object, required
            - `limit_price` string, required
            - `trigger_by` 'LastPrice' | 'IndexPrice' | 'MarkPrice', required
            - `trigger_price` string, required
    - `trigger` ConditionalOrder
      - `trigger_by` 'LastPrice' | 'IndexPrice' | 'MarkPrice', required
      - `trigger_direction` 'Up' | 'Down', required
      - `trigger_price` string, required — The price level that activates the order.

## Response `200`

Orders amended

- BatchAmendOrdersResponse — Response of batch amend orders.
  - `exit_info` ExitMessage[], required — Information about the exit status of each order in the batch.
    - union
      - object
        - `Error` object, required
          - `code` integer, required
          - `msg` string, required
      - object
        - `Success` object, required
          - `code` integer, required
          - `msg` string, required
  - `result` AmendOrderResponse[], required
    - `order_id` string, uuid
    - `order_link_id` string
  - `time` string, date-time, required

---

[API](https://skmtc.net/ekidenfi/apis/ekiden-gateway.md) · [All operations](https://skmtc.net/ekidenfi/apis/ekiden-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ekidenfi/ekiden-gateway/revisions/75ffe546b73a/schema)