Swap Reusable Quotes

Create Swap Reusable Quotes

SwapReusableQuotes are "held rates" offered by Ripio to swap assets at a specific price within a period of time. The typical Quotes workflow is as follows:

  • Partner performs a POST request to Swap Reusable Quote Endpoint, B2B will respond a price for a price valid for 30 second.
  • Present the offered price to the end-user, with a timer indicating the time to expiration (30 seconds).
  • If a user accepts the price, call Create Swap Reusable Quote Execution passing the reusable quote id, end user external ref, operation type and base or quote amount.
  • Call Get Transaction or Get Transaction List to query trade status information.
post/api/v1/swap-quotes/

Request

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

Request body

pairstring required

Indicates pair name.

external_refstring required

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

Response

Successful Response

idstring uuid required

UUID used as quote identifier.

statusstring
pairstring required

Indicates pair name involved in the quotation.

base_assetstring required

Indicates the base currency involved in the quotation.

quote_assetstring required

Indicates the quote currency involved in the quotation.

swap_ratestring decimal required

Indicates the exchange rate used for conversion.

usd_ratestring decimal required

Indicates the exchange rate between base_asset and USD currency, useful to calculate limits consumption.

external_refstring required

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

created_atstring date-time required

ISO DateTime indicating creation date.

expires_atstring date-time required

ISO DateTime indicating expiration date of the quote. Quote will be invalid after that date.

Changes

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