Quote Execution

Execute Quote

Quote Executions buy or sell assets using a Quote obtained from the Quote Creation flow.

The asset, operation type, and guaranteed price/rate of the execution are specified by the quote with ID quote_id.

The amount to buy or sell must be specified in either fiat or crypto by setting exactly one of:

  • base_amount to specify the amount of crypto to buy or sell.
  • quote_amount to specify the amount of fiat to spend or acquire.

An otherwise-valid request to create a quote execution may fail with the following types of errors:

  • Expired if the quote with ID quote_id has expired.
  • Insufficient Funds if the end user with ID end_user_id has insufficient available balance to fund the execution.
  • Already Executed Quote if a Quote has been already executed before.
  • Buy Limit Frequency Exceeded if the end_user reached a Daily/Monthly/Yearly frequency limit for BUY Trades.
  • Sell Limit Frequency Exceeded if the end_user reached a Daily/Monthly/Yearly frequency limit for SELL Trades.
  • Buy Limit Amount Exceeded if the end_user reached a Daily/Monthly/Yearly amount limit for BUY Trades.
  • Sell Limit Amount Exceeded if the end_user reached a Daily/Monthly/Yearly amount limit for SELL Trades.
post/api/v1/quotes/{quote_id}/actions/execute/

Request

  • Base URL: https://sandbox-b2b.ripio.com
  • URL: https://sandbox-b2b.ripio.com/api/v1/quotes/{quote_id}/actions/execute/
  • Auth: OAuth 2 (client credentials, token URL https://sandbox-b2b.ripio.com/oauth2/token/, scopes: read, write)

Path parameters

quote_idstring required

Request body

end_user_idstring required

Indicates End User external_ref.

Response

Successful response

idstring uuid required

UUID used as trade identifier.

txn_idstring required

UUID used as Transaction identifier. Useful to relate this object trade with a transaction object.

quote_idstring uuid required

UUID used as quote identifier.

end_user_idstring required

Arbitrary string used as end_user identifier.

ratestring required

Indicates the exchange rate used for conversion.

charged_feestring required

Indicates trade's applied fee.

base_amountstring required

Indicates the amount of units or equivalence in the quote for base currency.

quote_amountstring required

Indicates the amount of units or equivalence in the quote for quote currency.

base_assetstring required

Indicates the base currency involved in the quotation.

quote_assetstring required

Indicates the quote currency involved in the quotation.

created_atstring date-time required

ISO DateTime indicating creation date of trade.

Changes

No recorded changes to this operation across all 1 revision of this API.