Swap Reusable Quote Execution

Execute Swap Reusable Quote

Swap Quote Executions performs assets using a Reusable Quote obtained from the Swap Reusable Quote Creation flow.

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

The amount to swap must be specified by setting the following attribute:

  • base_amount to specify the amount of crypto that will be debited from base asset in order to accredit the equivalent quote asset.

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

  • Expired if the reusable quote with ID swap_quote_id has expired.
  • Insufficient Funds if the end user with ID end_user_id has insufficient available balance to fund the execution.
  • Swap Limit Frequency Exceeded if the end_user reached a Daily/Monthly/Yearly frequency limit for SWAP Trades.
  • Swap Limit Amount Exceeded if the end_user reached a Daily/Monthly/Yearly amount limit for SWAP Trades.
post/api/v1/swap-quotes/{swap_quote_id}/actions/execute/

Request

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

Path parameters

swap_quote_idstring required

Request body

end_user_idstring required

Indicates End User external_ref.

external_refstring required

Arbitrary identifier issued by the partner. Serves as an external identifier for lookups.

base_amountstring

Specifies the amount of crypto to buy or sell.

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.