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"
}
'

import requests

url = "https://app.sandbox.rio.trade/api/quotes"

payload = {
    "userId": "66290ac8bd3903485989f82e",
    "crypto": "TRX_USDT_S2UZ",
    "fiat": "MXN",
    "side": "buy",
    "amountFiat": 1000,
    "country": "MX"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userId: '66290ac8bd3903485989f82e',
    crypto: 'TRX_USDT_S2UZ',
    fiat: 'MXN',
    side: 'buy',
    amountFiat: 1000,
    country: 'MX'
  })
};

fetch('https://app.sandbox.rio.trade/api/quotes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sandbox.rio.trade/api/quotes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userId' => '66290ac8bd3903485989f82e',
    'crypto' => 'TRX_USDT_S2UZ',
    'fiat' => 'MXN',
    'side' => 'buy',
    'amountFiat' => 1000,
    'country' => 'MX'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sandbox.rio.trade/api/quotes"

	payload := strings.NewReader("{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sandbox.rio.trade/api/quotes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sandbox.rio.trade/api/quotes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}"

response = http.request(request)
puts response.read_body

{
  "userId": "66290ac8bd3903485989f82e",
  "crypto": "USDC",
  "side": "buy",
  "fiat": "USD",
  "paymentMethod": "bankTransfer",
  "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": 0.0555,
  "timeInForceStartsAt": "2024-06-04T15:02:13.097Z",
  "timeInForceEndsAt": "2024-06-04T15:02:13.097Z"
}

{
  "errors": [
    {
      "code": 19,
      "message": "Not authorized"
    }
  ]
}

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"
}
'

import requests

url = "https://app.sandbox.rio.trade/api/quotes"

payload = {
    "userId": "66290ac8bd3903485989f82e",
    "crypto": "TRX_USDT_S2UZ",
    "fiat": "MXN",
    "side": "buy",
    "amountFiat": 1000,
    "country": "MX"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userId: '66290ac8bd3903485989f82e',
    crypto: 'TRX_USDT_S2UZ',
    fiat: 'MXN',
    side: 'buy',
    amountFiat: 1000,
    country: 'MX'
  })
};

fetch('https://app.sandbox.rio.trade/api/quotes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sandbox.rio.trade/api/quotes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'userId' => '66290ac8bd3903485989f82e',
    'crypto' => 'TRX_USDT_S2UZ',
    'fiat' => 'MXN',
    'side' => 'buy',
    'amountFiat' => 1000,
    'country' => 'MX'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sandbox.rio.trade/api/quotes"

	payload := strings.NewReader("{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sandbox.rio.trade/api/quotes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sandbox.rio.trade/api/quotes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userId\": \"66290ac8bd3903485989f82e\",\n  \"crypto\": \"TRX_USDT_S2UZ\",\n  \"fiat\": \"MXN\",\n  \"side\": \"buy\",\n  \"amountFiat\": 1000,\n  \"country\": \"MX\"\n}"

response = http.request(request)
puts response.read_body

{
  "userId": "66290ac8bd3903485989f82e",
  "crypto": "USDC",
  "side": "buy",
  "fiat": "USD",
  "paymentMethod": "bankTransfer",
  "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": 0.0555,
  "timeInForceStartsAt": "2024-06-04T15:02:13.097Z",
  "timeInForceEndsAt": "2024-06-04T15:02:13.097Z"
}

{
  "errors": [
    {
      "code": 19,
      "message": "Not authorized"
    }
  ]
}

v1 (legacy). This page documents the API before the v2 update. The v1 format is not enabled for new accounts and must be enabled on your account by your account manager. New integrations should use the current documentation. To update an existing integration, follow the migration guide.

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,

XLM_USDC_5F3T,

USDC_BASECHAIN_ETH_5I5C,

USDCE_TEMPO_MXYR,

USDT_POLYGON,

USDT_ERC20,

TRX_USDT_S2UZ,

USDT_BSC,

SOL_USDT_EWAY,

EUROC_ETH_F5NG,

EURC_SOL,

EURC_B609K9QB_Y213

fiat

enum<string>

required

Fiat currency.

Available options:

USD,

MXN,

PEN,

COP

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,

CO

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

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

Limit price for limit orders, expressed like netPrice as units of what you receive per unit of what you pay (crypto per fiat on a buy, fiat per crypto on a sell). Only applicable when orderType is limit.

Example:

0.0555

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,

XLM_USDC_5F3T,

USDC_BASECHAIN_ETH_5I5C,

USDCE_TEMPO_MXYR,

USDT_POLYGON,

USDT_ERC20,

TRX_USDT_S2UZ,

USDT_BSC,

SOL_USDT_EWAY,

EUROC_ETH_F5NG,

EURC_SOL,

EURC_B609K9QB_Y213

side

enum<string>

Side of the quote.

Available options:

buy,

sell

fiat

enum<string>

Fiat currency.

Available options:

USD,

MXN,

PEN,

COP

paymentMethod

enum<string>

Payment method.

Available options:

bankTransfer

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,

CO

amountFiat

number

Amount in fiat currency.

Example:

1000

amountCrypto

number

Amount in crypto currency.

Example:

54.76

fees

object

Show child attributes

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

string

Id of the quote.

Example:

"665f2a99d6c964829d639812"

twoWaySettlementType

enum<string>

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

Example:

0.0555

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"

API Documentation

API List

Create Quote

Requirements to consume the endpoint.

Create and modify role

User approved

Authorizations

Body

Response

​Requirements to consume the endpoint.

Create and modify role

User approved

Authorizations

Body

Response

Requirements to consume the endpoint.