POST
/
api
/
quotes
Create Quote
curl --request POST \
  --url https://app.sandbox.rio.trade/api/quotes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "userId": "66290ac8bd3903485989f82e",
  "crypto": "TRX_USDT_S2UZ",
  "fiat": "MXN",
  "side": "buy",
  "amountFiat": 1000,
  "country": "MX"
}'
{
  "userId": "66290ac8bd3903485989f82e",
  "crypto": "USDC",
  "side": "buy",
  "fiat": "USD",
  "paymentMethod": "card",
  "expiresAt": "2024-06-04T14:59:17.286Z",
  "country": "MX",
  "amountFiat": 1000,
  "amountCrypto": 54.76,
  "fees": {
    "processingFeeFiat": 0,
    "transferFeeFiat": 0.17836118224825653,
    "platformFeeFiat": 20
  },
  "marketPrice": 0.0560660109669,
  "createdAt": "2024-06-04T14:54:17.286Z",
  "quoteInCrypto": false,
  "reissueAfterExpiration": true,
  "netPrice": 0.97671,
  "id": "665f2a99d6c964829d639812",
  "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"
}

​
Requirements to consume the endpoint.

Create and modify role

The user must have the role to create and modify.

User approved

The user must be approved in at least one country.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
crypto
enum<string>
required

Crypto currency.

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

Fiat currency.

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

Side of the quote.

Available options:
buy,
sell
​
country
enum<string>
required

Country where you want to make the quotation.

Available options:
MX,
PE,
US
​
userId
string

Id of the user to which this quote will be associated.

Example:

"66290ac8bd3903485989f82e"

​
amountFiat
number

This attribute is used to specify the amount of fiat currency you want to convert to cryptocurrency. You should provide it when you know the exact amount of fiat currency you want to spend.

Example:

1000

​
orderId
string

This attribute is used to relate the quote to an existing order.

Example:

"63290ac8bd3903485989062f"

​
amountCrypto
number

This attribute is used to specify the amount of cryptocurrency you want to buy. You should provide it when you know the exact amount of cryptocurrency you want to buy.

Example:

1000

​
USBankTransferMethod
enum<string>

Required for orders in the US. For a buy order, this specifies the transfer method used to pay for the order. For a sell order, this specifies the transfer method used to receive the payment.

Available options:
ach_push,
wire
​
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

​
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"

Response

Created

​
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>

Payment method.

Available options:
card,
bankTransfer,
cash
​
expiresAt
string

Expiration date and time of the quote.

Example:

"2024-06-04T14:59:17.286Z"

​
country
enum<string>

Country of the quote.

Available options:
MX,
PE,
US
​
amountFiat
number

Amount in fiat currency.

Example:

1000

​
amountCrypto
number

Amount in crypto currency.

Example:

54.76

​
fees
object
​
marketPrice
number

Price of the cryptocurrency in fiat currency.

Example:

0.0560660109669

​
createdAt
string

Creation date and time of the quote.

Example:

"2024-06-04T14:54:17.286Z"

​
quoteInCrypto
boolean

Whether the quote is in crypto currency.

Example:

false

​
reissueAfterExpiration
boolean

Whether to reissue the quote after expiration.

Example:

true

​
netPrice
number

The final price of the order, including taxes and fees

Example:

0.97671

​
id
string

Id of the quote.

Example:

"665f2a99d6c964829d639812"

​
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"