---
title: "Create a Buy Trade - Credit Card"
method: POST
path: "/trades"
---

# Create a Buy Trade - Credit Card

`POST /trades`

## Request

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

This page describes how to Create a Buy Trade via API where the payment method for completing the trade is Credit Card transfer.

## 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 Credit Card Buy trade, the value is `card`.
    - `details` object: Can be used to supply `returnUrl` to which the end-user will be redirected once the Credit Card payment is confirmed.
      - `returnUrl` string: The return URL to which the user to be sent back after the payment has been created. Can be provided when creating a trade.
  - `transferOut` object, required
    - `medium` string, required: Transfer medium. Defines the outgoing side of the trade - transfer the end-user will receive once the payment is completed.
    - `details` object
      - `account` string, required: Receiving blockchain address for this trade.
      - `accountSignature` string: HMAC-SHA-256 signature signing the account value. Required only if a shared secret has been established with Coinify.
      - `memo` string: Optional memo for currencies where memo/destination tag is supported.
  - `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
      - `redirectUrl` string
      - `provider` string
      - `isApplePayAvailable` boolean
      - `cardPaymentId` string
  - `transferOut` object
    - `id` integer
    - `sendAmount` number
    - `receiveAmount` number
    - `currency` string
    - `medium` string
    - `details` object
      - `account` string
  - `createTime` string
  - `updateTime` string
  - `isPriceQuoteApproximate` boolean
  - `quoteExpireTime` string

## Other responses

- `401`: 401

## Changes

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

[Operation history](https://skmtc.dev/coinify/apis/coinify-trade/changes/trades/post.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)