Convert a Quote

Once you have created a Quote, you can execute it to complete the conversion and create a trackable conversion transaction.

Execution Basics

Quote execution consists of:

quote_id: the unique identifier from a previously created quote
The quote must be in ACTIVE status and not expired
Execution will create a conversion transaction with tracking information
You receive a conversion ID to monitor and retrieve the transaction details

⚠️ Important: Once expired, quotes cannot be converted and will return a quote_not_found error.

Endpoint URL

You can execute a Quote by posting to the following URL:

POST https://api.bitso.com/rfq/v1/conversions

Request

Fields

Field	Type	Required	Description
`quote_id`	string	Yes	The ID of the Quote to be converted

Payload Example

{
  "quote_id": "38af5e7e-2dd0-4af0-a03c-895662a1ea21"
}

Response

Fields

Field	Type	Description
`id`	string	Unique conversion transaction ID for tracking
`source`	string	Source currency (what you're selling)
`target`	string	Target currency (what you're buying)
`source_amount`	string	Amount of source currency converted
`target_amount`	string	Amount of target currency received
`quote_id`	string	Original quote ID that was executed
`rate`	string	Exchange rate applied (including fees)
`fee_amount`	string	Total fee charged for the conversion
`fee_currency`	string	Currency in which the fee was charged
`status`	string	Conversion status (`COMPLETED`, `FAILED`, etc.)
`quoted_at`	string	When the original quote was created (ISO 8601)
`created_at`	string	When the conversion was executed (ISO 8601)
`updated_at`	string	Last update timestamp (ISO 8601)

Payload Example

{
  "id": "38af5e7e-2dd0-4af0-a03c-895662a1ea21",
  "source": "USDT",
  "target": "BTC",
  "source_amount": "68206.00",
  "target_amount": "1.0",
  "quote_id": "38af5e7e-2dd0-4af0-a03c-895662a1ea21",
  "rate": "68206.00",
  "fee_amount": "341.03",
  "fee_currency": "USDT",
  "status": "COMPLETED",
  "quoted_at": "2025-08-04T20:50:33Z",
  "created_at": "2024-06-24T14:15:22Z",
  "updated_at": "2024-06-24T14:15:22Z"
}

Error

Responses

Status Code	Error Code	Error Message
400	`quote_not_found`	Quote ID doesn't exist
400	`insufficient_funds`	Not enough balance to complete conversion
400	`quote_already_executed`	Quote was previously executed
400	`quote_cancelled`	Quote was cancelled before execution
403	`forbidden_request`	User not allowed to use RFQ API

Payload Example

{
  "errors": [
    {
      "code": "quote_not_found",
      "message": "Quote with the specified ID was not found."
    }
  ]
}