---
title: "Cancel trade"
method: PATCH
path: "/trades/{id}/cancel"
---

# Cancel trade

`PATCH /trades/{id}/cancel`

## Request

- Base URL: `https://app-api.sandbox.coinify.com`
- URL: `https://app-api.sandbox.coinify.com/trades/{id}/cancel`
- Auth: none required

This endpoint cancels the trade in the `awaiting_transfer_in` [state](https://coinify-trade-api.readme.io/reference/trade-states) and returns a [trade object](https://coinify-trade-api.readme.io/reference/trade-resource#trade-object) for the cancelled trade.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- union
  - object
    - `id` integer
    - `trackingId` string
    - `state` string
    - `traderId` integer
    - `traderEmail` string
    - `inAmount` integer
    - `inCurrency` string
    - `outCurrency` string
    - `outAmountExpected` number
    - `transferIn` object
      - `id` integer
      - `sendAmount` integer
      - `receiveAmount` integer
      - `currency` string
      - `medium` string
      - `details` object
        - `account` string
        - `memo` unknown
        - `paymentUri` string
      - `mediumTransactionId` string
    - `transferOut` object
      - `id` integer
      - `sendAmount` number
      - `receiveAmount` number
      - `currency` string
      - `medium` string
      - `details` object
        - `account` object
          - `bic` string
          - `number` string
          - `currency` string
        - `bank` object
          - `name` unknown
          - `address` object
            - `state` unknown
            - `country` string
        - `holder` object
          - `name` string
          - `address` object
            - `city` string
            - `state` string
            - `street` string
            - `country` string
            - `zipcode` string
      - `mediumReceiveAccountId` integer
    - `createTime` string
    - `updateTime` string
    - `isPriceQuoteApproximate` boolean
  - object
    - `id` integer
    - `trackingId` string
    - `state` string
    - `traderId` integer
    - `traderEmail` string
    - `inAmount` integer
    - `inCurrency` string
    - `outCurrency` string
    - `outAmountExpected` number
    - `transferIn` object
      - `id` integer
      - `sendAmount` integer
      - `receiveAmount` integer
      - `currency` string
      - `medium` string
      - `details` object
        - `provider` string
        - `returnUrl` string
        - `redirectUrl` string
        - `cardPaymentId` string
        - `isApplePayAvailable` boolean
    - `transferOut` object
      - `id` integer
      - `sendAmount` number
      - `receiveAmount` number
      - `currency` string
      - `medium` string
      - `details` object
        - `account` string
    - `createTime` string
    - `updateTime` string
    - `isPriceQuoteApproximate` boolean
  - object
    - `id` integer
    - `trackingId` string
    - `state` string
    - `traderId` integer
    - `traderEmail` string
    - `inAmount` integer
    - `inCurrency` string
    - `outCurrency` string
    - `outAmountExpected` number
    - `transferIn` object
      - `id` integer
      - `sendAmount` number
      - `receiveAmount` integer
      - `currency` string
      - `medium` string
      - `details` object
        - `account` object
          - `bic` string
          - `type` string
          - `number` string
          - `currency` string
        - `bank` object
          - `name` string
          - `address` object
            - `city` string
            - `street` string
            - `country` string
            - `zipcode` string
        - `holder` object
          - `name` string
          - `address` object
            - `city` string
            - `street` string
            - `country` string
            - `zipcode` string
        - `referenceText` string
    - `transferOut` object
      - `id` integer
      - `sendAmount` number
      - `receiveAmount` number
      - `currency` string
      - `medium` string
      - `details` object
        - `account` string
    - `createTime` string
    - `updateTime` string
    - `isPriceQuoteApproximate` boolean

## Changes

- **2026-11-03** `f2f9558d29a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coinify/apis/coinify-trade/changes/trades/:id/cancel/patch.md)

---

[API](https://skmtc.dev/coinify/apis/coinify-trade.md) - [All operations](https://skmtc.dev/coinify/apis/coinify-trade/llms.txt) - [OpenAPI document](https://skmtc.dev/coinify/apis/coinify-trade/revisions/f2f9558d29a5?raw)