Quotes

Create Quote

Quotes 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.
  • User Selects a Pair of interest and ask for a BUY/SELL Quotation.
  • Partner performs a POST request to Quote Endpoint, providing a base OR quote amount. B2B will respond a price for the given amount.
  • 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 Quote Execution passing the quote id.
  • Call Get Transaction or Get Transaction List to query trade status information.

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

  • Buy Transaction Min Limit Exceeded if the amount is lower than the minimum amount allowed on BUY operations.
  • Buy Transaction Max Limit Exceeded if the amount is higher than the maximum amount allowed on BUY operations.
  • Sell Transaction Min Limit Exceeded if the amount is lower than the minimum amount allowed on SELL operations.
  • Sell Transaction Max Limit Exceeded if the amount is higher than the maximum amount allowed on SELL operations.
post/api/v1/quotes/

Request

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

op_type'BUY' | 'SELL' required

Indicates the operation type.

base_amountnumber

Specifies the amount of crypto to buy or sell.

quote_amountnumber

Specifies the amount of fiat to buy or sell.

Response

Successful Response

idstring uuid required

UUID used as quote identifier.

pairstring required

Indicates pair name involved in the quotation.

op_type'BUY' | 'SELL' required

Indicates whether the quote is for BUY or SELL.

base_assetstring required

Indicates the base currency involved in the quotation.

quote_assetstring required

Indicates the quote currency involved in the quotation.

base_amountstring decimal required

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

quote_amountstring decimal required

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

ratestring decimal required

Indicates the exchange rate used for conversion.

charged_feestring decimal required

Indicates fee that will be applied when the execution of quote is effective.

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.