---
title: "Cancel Orders"
method: POST
path: "/api/v2/accounts/{account_id}/orders/cancel"
tags: ["Orders"]
---

# Cancel Orders

`POST /api/v2/accounts/{account_id}/orders/cancel`

## Request

- Base URL: `https://api-enterprise.sbt.dinari.com`
- URL: `https://api-enterprise.sbt.dinari.com/api/v2/accounts/{account_id}/orders/cancel`
- Auth: API key in header `X-API-Key-Id` and API key in header `X-API-Secret-Key`
- TypeScript: <https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/docs/api/v2/accounts/:account_id/orders/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

Cancel multiple `Orders` by their IDs in a single request. Note that this requires the `Order` IDs, not the `OrderRequest` IDs.
Once you submit a cancellation request, it cannot be undone. Be advised that orders with a
status of PENDING_FILL, PENDING_ESCROW, FILLED, REJECTED, or CANCELLED cannot be cancelled.

`Order` cancellation is not guaranteed nor is it immediate. The `Orders` may still be executed
if the cancellation request is not received in time.

The response will indicate which orders were successfully queued to cancel and which failed to queue.
Check the status using the "Get Order by ID" endpoint to confirm whether individual `Orders` have been cancelled.

## Request body

- BatchCancelOrderInput: Input parameters for requesting `Order` cancellations from a list of `Order` IDs.
  - `order_ids` string[], required: List of `Order` IDs to cancel

## Response `200`

OK

- BatchCancelOrderResponse
  - `cancel_queued_orders` Order[], required: Orders that were queued to cancel.
    - `id` string, uuid, required: ID of the `Order`.
    - `status` 'PENDING_SUBMIT' | 'PENDING_CANCEL' | 'PENDING_ESCROW' | 'PENDING_FILL' | 'ESCROWED' | 'SUBMITTED' | 'CANCELLED' | 'PARTIALLY_FILLED' | 'FILLED' | 'REJECTED' | 'REQUIRING_CONTACT' | 'ERROR', required
    - `chain_id` 'eip155:1' | 'eip155:42161' | 'eip155:8453' | 'eip155:81457' | 'eip155:98866' | 'eip155:999' | 'eip155:43114' | 'eip155:56' | 'eip155:5042' | 'eip155:1329' | 'eip155:11155111' | 'eip155:421614' | 'eip155:84532' | 'eip155:168587773' | 'eip155:98867' | 'eip155:998' | 'eip155:43113' | 'eip155:97' | 'eip155:5042002' | 'eip155:1328' | 'eip155:202110' | 'eip155:179205' | 'eip155:179202' | 'eip155:98865' | 'eip155:7887', required
    - `order_contract_address` string, eth_address, required: Smart contract address that `Order` was created from.
    - `order_transaction_hash` string, hex_string, required: Transaction hash for the `Order` creation.
    - `order_side` 'BUY' | 'SELL', required
    - `order_type` 'MARKET' | 'LIMIT', required
    - `order_tif` 'DAY' | 'GTC' | 'IOC' | 'FOK', required
    - `payment_token` string, eth_address, required: The payment token (stablecoin) address.
    - `created_dt` string, date-time, required: Datetime at which the `Order` was created. ISO 8601 timestamp.
    - `stock_id` string, uuid, nullable: The `Stock` ID associated with the `Order`
    - `alloy_id` string, uuid, nullable: The `Alloy` ID associated with the `Order`
    - `asset_token` string, eth_address, nullable: The dShare asset token address.
    - `asset_token_quantity` string, decimal, nullable: Total amount of assets involved.
    - `payment_token_quantity` string, decimal, nullable: Total amount of payment involved.
    - `limit_price` string, decimal, nullable: For limit `Orders`, the price per asset, specified in the `Stock`'s native currency (USD for US equities and ETFs).
    - `fee` string, decimal, nullable: Fee amount associated with `Order`.
    - `cancel_transaction_hash` string, hex_string, nullable: Transaction hash for cancellation of `Order`, if the `Order` was cancelled.
    - `order_request_id` string, uuid, nullable: Order Request ID for the `Order`
    - `client_order_id` string, nullable: Customer-supplied unique identifier to map this `Order` to an order in the customer's systems.
  - `failed_to_cancel_orders` Order[], required: Orders that could not be queued to cancel.
    - `id` string, uuid, required: ID of the `Order`.
    - `status` 'PENDING_SUBMIT' | 'PENDING_CANCEL' | 'PENDING_ESCROW' | 'PENDING_FILL' | 'ESCROWED' | 'SUBMITTED' | 'CANCELLED' | 'PARTIALLY_FILLED' | 'FILLED' | 'REJECTED' | 'REQUIRING_CONTACT' | 'ERROR', required
    - `chain_id` 'eip155:1' | 'eip155:42161' | 'eip155:8453' | 'eip155:81457' | 'eip155:98866' | 'eip155:999' | 'eip155:43114' | 'eip155:56' | 'eip155:5042' | 'eip155:1329' | 'eip155:11155111' | 'eip155:421614' | 'eip155:84532' | 'eip155:168587773' | 'eip155:98867' | 'eip155:998' | 'eip155:43113' | 'eip155:97' | 'eip155:5042002' | 'eip155:1328' | 'eip155:202110' | 'eip155:179205' | 'eip155:179202' | 'eip155:98865' | 'eip155:7887', required
    - `order_contract_address` string, eth_address, required: Smart contract address that `Order` was created from.
    - `order_transaction_hash` string, hex_string, required: Transaction hash for the `Order` creation.
    - `order_side` 'BUY' | 'SELL', required
    - `order_type` 'MARKET' | 'LIMIT', required
    - `order_tif` 'DAY' | 'GTC' | 'IOC' | 'FOK', required
    - `payment_token` string, eth_address, required: The payment token (stablecoin) address.
    - `created_dt` string, date-time, required: Datetime at which the `Order` was created. ISO 8601 timestamp.
    - `stock_id` string, uuid, nullable: The `Stock` ID associated with the `Order`
    - `alloy_id` string, uuid, nullable: The `Alloy` ID associated with the `Order`
    - `asset_token` string, eth_address, nullable: The dShare asset token address.
    - `asset_token_quantity` string, decimal, nullable: Total amount of assets involved.
    - `payment_token_quantity` string, decimal, nullable: Total amount of payment involved.
    - `limit_price` string, decimal, nullable: For limit `Orders`, the price per asset, specified in the `Stock`'s native currency (USD for US equities and ETFs).
    - `fee` string, decimal, nullable: Fee amount associated with `Order`.
    - `cancel_transaction_hash` string, hex_string, nullable: Transaction hash for cancellation of `Order`, if the `Order` was cancelled.
    - `order_request_id` string, uuid, nullable: Order Request ID for the `Order`
    - `client_order_id` string, nullable: Customer-supplied unique identifier to map this `Order` to an order in the customer's systems.

## Other responses

- `422`: Unprocessable Entity
- `default`: Default error response

## Changes

- **2026-11-03** `923eb2967c79`: 8 breaking, 6 warning, 2 info
  - the `cancel_queued_orders/items/asset_token_quantity` response's property type changed from `number, null` to `string, null`, and format from no format to `decimal` for status `200`
  - the `cancel_queued_orders/items/fee` response's property type changed from `number, null` to `string, null`, and format from no format to `decimal` for status `200`
  - the `cancel_queued_orders/items/limit_price` response's property type changed from `number, null` to `string, null`, and format from no format to `decimal` for status `200`
  - the `cancel_queued_orders/items/payment_token_quantity` response's property type changed from `number, null` to `string, null`, and format from no format to `decimal` for status `200`
  - …12 more
- **2026-06-18** `ad31890c2e0e`: 2 warning
  - added the new `eip155:43114` enum value to the `cancel_queued_orders/items/chain_id` response property for the response status `200`
  - added the new `eip155:43114` enum value to the `failed_to_cancel_orders/items/chain_id` response property for the response status `200`

[Operation history](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/changes/api/v2/accounts/:account_id/orders/cancel/post.md)

---

[API](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api.md) - [All operations](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/revisions/923eb2967c79?raw)