---
title: "Create Sell Trade - Blockchain transfer"
method: POST
path: "/trades"
---

# Create Sell Trade - Blockchain transfer

`POST /trades`

## Request

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

This page explains how to create a crypto-to-FIAT Sell trade where the funds are delivered to the end-user via bank transfer once the trade is completed.

## Headers

- `Authorization` string, required

## Request body

- object
  - `priceQuoteId` integer, required: Identifier of a valid price quote to base the trade on. Passing an invalid price quote will result in an error.
  - `transferIn` object, required
    - `medium` string, required: Defines how the end-user will transfer the funds to complete the trade. In case of creating Blockchain Sell trade, the value is `blockchain`.
    - `details` object
      - `refundAccount` string: Only defined if `baseCurrency` != `BTC` in a Sell trade. Defines the cryptocurrency address to refund to in case of a failure.
      - `refundAccountSignature` string: HMAC-SHA-256 signature signing the refundAccount value. Only defined if `refundAccount` is defined and if a shared secret has been established with Coinify.
  - `transferOut` object, required
    - `medium` string, required: Defines the type of the outgoing transfer that the end-user will receive. In the case of Blockchain Sell trade, it's a `bank` transfer..
    - `mediumReceiveAccountId` string, required: Bank account of the trader. Required only in case of crypto to FIAT via Bank transfer Sell trade.
  - `partnerContext` string, json: Partner context which will be returned in trade webhooks. Can be one of object, array, string, number, true, false as defined here https://www.json.org/json-en.html.

## Response `200`

200

- 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
        - `currency` string
        - `number` string
      - `bank` object
        - `address` object
          - `country` string
          - `state` unknown
        - `name` unknown
      - `holder` object
        - `address` object
          - `city` string
          - `country` string
          - `state` string
          - `street` string
          - `zipcode` string
        - `name` string
    - `mediumReceiveAccountId` integer
  - `createTime` string
  - `updateTime` string
  - `isPriceQuoteApproximate` boolean
  - `quoteExpireTime` string

## Other responses

- `401`: 401

---

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