Create Sell Trade - Blockchain transfer

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.

post/trades

Request

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

Headers

Authorizationstring required

Must contain Bearer <access_token> value as received upon Authentication.

Request body

priceQuoteIdinteger required

Identifier of a valid price quote to base the trade on. Passing an invalid price quote will result in an error.

partnerContextstring 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

idinteger

trackingIdstring

statestring

traderIdinteger

traderEmailstring

inAmountinteger

inCurrencystring

outCurrencystring

outAmountExpectednumber

createTimestring

updateTimestring

isPriceQuoteApproximateboolean

quoteExpireTimestring

Example response

{
  "id": 209261,
  "trackingId": "8f35d1e9-5e52-4bfe-95bf-7d374c4af670",
  "state": "awaiting_transfer_in",
  "traderId": 13450,
  "traderEmail": "sni+alltest@coinify.com",
  "inAmount": 1,
  "inCurrency": "ETH",
  "outCurrency": "DKK",
  "outAmountExpected": 16123.28,
  "transferIn": {
    "id": 621644,
    "sendAmount": 1,
    "receiveAmount": 1,
    "currency": "ETH",
    "medium": "blockchain",
    "details": {
      "account": "0x42cE19972118a6F59fcA1D7E13A09712E9C83884",
      "paymentUri": "ethereum:0x42cE19972118a6F59fcA1D7E13A09712E9C83884?value=1e18"
    },
    "mediumTransactionId": "f3c93f11-0ba8-4103-be03-76ceb6a4d757"
  },
  "transferOut": {
    "id": 621645,
    "sendAmount": 16123.28,
    "receiveAmount": 14349.72,
    "currency": "DKK",
    "medium": "bank",
    "details": {
      "account": {
        "bic": "NDEADKKK",
        "currency": "DKK",
        "number": "DK5000400440116243"
      },
      "bank": {
        "address": {
          "country": "DK"
        }
      },
      "holder": {
        "address": {
          "city": "Exampleville",
          "country": "US",
          "state": "CA",
          "street": "123 Example Street",
          "zipcode": "12345"
        },
        "name": "John Doe"
      }
    },
    "mediumReceiveAccountId": 43263
  },
  "createTime": "2024-11-05T13:44:48.091Z",
  "updateTime": "2024-11-05T13:44:48.091Z",
  "quoteExpireTime": "2024-11-05T13:58:48.063Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.