Reusable Quotes

Create Reusable Quote

ReusableQuotes are "held rates" offered by Ripio to buy or sell assets at a specific price within a period of time - for example, the option to buy ETH within the next 30 seconds for $10,000.

The typical Quotes workflow is as follows:

  • Call List Market Rates to get the latest available quoted prices for the assets you want to buy or sell. Please note that these rates are subject to change depending on the amount of base/quote currency the end user is willing to trade.
  • Partner performs a POST request to ReusableQuote 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 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/reusable-quotes/

Request

  • Base URL: https://sandbox-b2b.ripio.com
  • URL: https://sandbox-b2b.ripio.com/api/v1/reusable-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.

status'COM' | 'PEN' | 'EXP' | 'UNA_PRICE'
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.

buy_ratestring decimal required

Indicates the exchange rate used for conversion.

sell_ratestring decimal required

Indicates the exchange rate used for conversion.

market_buy_ratestring decimal required

Indicates the exchange rate used for conversion, without the applied fee.

market_sell_ratestring decimal required

Indicates the exchange rate used for conversion, without the applied fee.

buy_fee_percentagestring decimal required

Indicates the fee percentage applied to market_buy_rate to obtain buy_rate.

sell_fee_percentagestring decimal required

Indicates the fee percentage applied to market_sell_rate to obtain sell_rate.

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.