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

Header Parameters

You must specify the following authentication parameters in your request:

ParameterDescriptionRequired
keySee the section, AuthenticationYes
signatureSee the section, AuthenticationYes
nonceSee the section, AuthenticationYes

Path Parameters

You must specify the following path parameter in your request:

ParameterDescriptionRequired
quote_idIdentifies 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 NameDescriptionType
oidThe conversion's unique ID.String