Execute a Conversion Quote

The PUT /api/v4/currency_conversions/{quote_id} method enables you to execute a conversion quote within the 30-second expiration limit. You use the value of the variable id returned by the request-quote call to submit the conversion to Bitso's Conversion Engine. After you submit a conversion, it starts executing asynchronously.

It is impossible to cancel the execution of a conversion quote once you have submitted it.

HTTP Request

PUT https://stage.bitso.com/api/v4/currency_conversions/{quote_id}

Header Parameters

You must specify the following authentication parameters in your request:

Parameter	Description	Required
`key`	See the section, Authentication	Yes
`signature`	See the section, Authentication	Yes
`nonce`	See the section, Authentication	Yes

Path Parameters

You must specify the following path parameter in your request:

Parameter	Description	Required
`quote_id`	Identifies the quote you want to execute. The request-quote call returns it as `id`.	Yes

JSON Response Payload

A successful call returns a JSON object representing the executed conversion. The following response object exemplifies the JSON object returned:

{
    "success": true,
    "payload": {
        "oid": "7316"
    }
}

The value of the oid variable is the path parameter (conversion_id) you need to use when getting-a-conversion-status.

The meaning of the response object field is as follows:

Field Name	Description	Type
`oid`	The conversion's unique ID.	String