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

# Cancel Order

`POST /api/v1/order/cancel`

## Request

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

Cancel an existing order

## Request body

- CancelOrderRequest: Request to cancel an order.
  - `order_id` string, uuid
  - `order_link_id` string
  - `sub_account_address` string, required
  - `symbol` string, required

## Response `200`

Order canceled

- CancelOrderResponse: Response for canceling an order.
  - `order_id` string, uuid
  - `order_link_id` string

## Changes

- **2026-05-28** `75ffe546b73a`: 3 breaking
  - 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`
  - the `order_id` response's property type changed from `string` to no type, and format from `uuid` to no format for status `200`
- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/order/cancel/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)
