Creating quote

Create quote

POST /api/public/v1/exchange/quotes

This endpoint creates quotes.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_token>

Body

Name	Type	Description
data	object	Object with exchange request data.
data.type	string	Exchange request type. Always quotes.
data.attributes	object	A set of exchange request attributes.
data.attributes.accountChargedId	string	Account ID from which funds are being converted. See Listing Accounts.
data.attributes.accountReceivedId	string	Account ID to which funds are being converted. See Listing Accounts.
data.attributes.amount	number	Exchange amount.
data.attributes.amountCurrency	string	Exchange amount currency. Can be the currency associated with the accountCharged or accountReceived.

Request JSON

{
  "data": {
    "type": "quotes",
    "attributes": {
      "accountChargedId": string,
      "accountReceivedId": string,
      "amount": number,
      "amountCurrency": string
    }
  }
}

Response

HTTP 200

{
  "data": {
    "id": "d00edf6e-aa93-4461-ba0b-ebc9055e9e1b",
    "type": "exchangeQuotes",
    "attributes": {
      "expiresAt": "2025-05-23T09:49:47.431Z",
      "amountCharged": "0.0010418",
      "amountReceived": "100.0",
      "rate": "96947.532",
      "exchangeFee": "1.00",
      "exchangeFeeCurrency": "EUR",
      "rateCurrency": "EUR",
      "accountChargedId": "5850abb7-0a60-4041-800c-1d43b4dcf4d6",
      "accountReceivedId": "acd50522-de49-4aaa-a183-dc046ff27fd5",
      "status": "pending",
      "amountChargedCurrency": "BTC",
      "amountReceivedCurrency": "EUR"
    },
    "relationships": {
      "exchangeOrder": {
        "data": {
          "type": "orders",
          "id": "44f5d889-1532-4846-ad8d-3796de9cf49d"
        }
      },
      "transactions": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "44f5d889-1532-4846-ad8d-3796de9cf49d",
      "type": "orders",
      "attributes": {
        "baseCode": "BTC",
        "quoteCode": "EUR",
        "quantity": "0.0010418"
      }
    }
  ],
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "amount is below minimum",
      "code": "amount_below_minimum"
    }
  ]
}

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "amount is above maximum",
      "code": "amount_above_maximum"
    }
  ]
}

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "account has insufficient balance",
      "code": "account_has_insufficient_balance"
    }
  ]
}

Response Body

Name	Type	Description
data.id	string	Quote ID.
data.type	string	Entity type returned. Always exchangeQuotes.
data.attributes	object	A set of quote attributes.
data.attributes.amountCharged	string	Amount to be debited from your accountChargedId.
data.attributes.amountChargedCurrency	string	Account charged currency code.
data.attributes.amountReceivedCurrency	string	Account received cyrrency code.
data.attributes.amountReceived	string	Amount to be credited to your accountReceivedId.
data.attributes.rate	string	Exchange rate.
data.attributes.status	string	One of: pending, completed, expired, or failed. Note: A transaction with status failed can be updated to completed via a support request.
data.attributes.rateCurrency	string	Exchange rate currency code.
data.attributes.exchangeFee	string	Txn fee amount.
data.attributes.exchangeFeeCurrency	string	Fee currency code.
data.attributes.expiresAt	string	Quote expiry timestamp.