GET
/
api
/
quotes
/
{id}
Get Quote by ID
curl --request GET \
  --url https://app.sandbox.rio.trade/api/quotes/{id} \
  --header 'x-api-key: <api-key>'
{
  "fees": {
    "processingFeeFiat": 0,
    "transferFeeFiat": 0.17832524656482562,
    "platformFeeFiat": 20
  },
  "userId": "66290ac8bd3903485989f82e",
  "crypto": "USDC",
  "side": "buy",
  "fiat": "USD",
  "paymentMethod": "card",
  "expiresAt": "2024-06-04T15:07:13.097Z",
  "country": "MX",
  "amountFiat": 1000,
  "amountCrypto": 54.77,
  "marketPrice": 0.0560773092573,
  "createdAt": "2024-06-04T15:02:13.097Z",
  "quoteInCrypto": false,
  "reissueAfterExpiration": true,
  "netPrice": 0.97671,
  "twoWaySettlementType": "default",
  "twoWaySettlementDateOffset": 1,
  "twoWaySettlementDate": "2024-06-04T15:02:13.097Z",
  "effectiveTwoWaySettlementDateOffset": 1,
  "paymentDueDate": "2024-06-04T15:02:13.097Z",
  "orderType": "market",
  "limitNetPrice": 18.75,
  "timeInForceStartsAt": "2024-06-04T15:02:13.097Z",
  "timeInForceEndsAt": "2024-06-04T15:02:13.097Z",
  "id": "665f2c75d6c964829d6398f4"
}
Note: Quotes that have not been used in the settlement of an order are deleted after 7 days.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Id of the quote to be obtained.

Response

OK

​
fees
object
​
userId
string

Id of the user who created the quote.

Example:

"66290ac8bd3903485989f82e"

​
crypto
enum<string>

Crypto currency.

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
side
enum<string>

Side of the quote.

Available options:
buy,
sell
​
fiat
enum<string>

Fiat currency.

Available options:
USD,
MXN,
PEN
​
paymentMethod
enum<string>

The method of payment used in the transaction.

Available options:
card,
bankTransfer,
cash
​
expiresAt
string

Date and time at which the quote is no longer valid and cannot be used to create an order. This value is undefined in buy and sell orders where the fiat value is USD , as those quotes do not expire.

Example:

"2024-06-04T15:07:13.097Z"

​
country
enum<string>

The country where the quote is applicable.

Available options:
MX,
PE,
US
​
amountFiat
number

The transaction amount in the fiat currency.

Example:

1000

​
amountCrypto
number

The transaction amount in the cryptocurrency.

Example:

54.77

​
marketPrice
number

The current price of the cryptocurrency in the fiat currency.

Example:

0.0560773092573

​
createdAt
string

The date and time when the quote was created.

Example:

"2024-06-04T15:02:13.097Z"

​
quoteInCrypto
boolean

Indicates if the quote is provided in the cryptocurrency.

Example:

false

​
reissueAfterExpiration
boolean

Indicates if a new quote should be issued after the current one expires.

Example:

true

​
netPrice
number

The final price of the order, including taxes and fees

Example:

0.97671

​
twoWaySettlementType
enum<string>

The type of settlement for the order. default means that the order is settles regularly (usually this means upon receipt of the payment), while TPlusOffset means that the order is settled after a certain number of business days.

Available options:
default,
TPlusOffset
​
twoWaySettlementDateOffset
number

The number of business days until the order is settled. This is only applicable for if the twoWaySettlementType is TPlusOffset.

Example:

1

​
twoWaySettlementDate
string

The date on which the order is settled.

Example:

"2024-06-04T15:02:13.097Z"

​
effectiveTwoWaySettlementDateOffset
number

The number of billable days until the order is settled. This is only applicable for if the twoWaySettlementType is TPlusOffset.

Example:

1

​
paymentDueDate
string

The date on which the payment is due.

Example:

"2024-06-04T15:02:13.097Z"

​
orderType
enum<string>

The type of order. market means that the order is executed at the current market price, while limit means that the order is executed at a specified limit net price.

Available options:
market,
limit
​
limitNetPrice
number

The net price of the order. This is only applicable for if the orderType is limit.

Example:

18.75

​
timeInForceStartsAt
string

The date and time from which the order is scheduled to be executed (optional).

Example:

"2024-06-04T15:02:13.097Z"

​
timeInForceEndsAt
string

The date and time until which the order is scheduled to be executed (optional).

Example:

"2024-06-04T15:02:13.097Z"

​
id
string

The unique identifier of the quote.

Example:

"665f2c75d6c964829d6398f4"