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

# Amend Order

`POST /api/v1/order/amend`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/order/amend`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/order/amend/post.ts> (a function with typed inputs; its response is checked against the schema)

Amend an existing order

## Request body

- AmendOrderRequest: Request to amend an order.
  - `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`

Order amended

- AmendOrderResponse: Response for amending an order.
  - `order_id` string, uuid
  - `order_link_id` string

## Changes

- **2026-05-28** `75ffe546b73a`: 5 breaking, 1 warning
  - added the new required request property `qty`
  - the `price` request property type changed from `integer` to `string`, and format from `int64` to no format
  - the response property `order_id` became optional for the status `200`
  - added `#/components/schemas/OrderId, subschema #1` to the `order_id` response property `oneOf` list for the response status `200`
  - …2 more
- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/order/amend/post.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)