Quote a cross-chain deposit
curl --request POST \
--url https://api.rheon.io/v1/deposit/quote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": {
"address": "0x1111111111111111111111111111111111111111",
"chain": 8453,
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"destination": {
"address": "0x2222222222222222222222222222222222222222",
"chain": 42161,
"token": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
},
"amount": "5000000",
"method": "crypto"
}
'import requests
url = "https://api.rheon.io/v1/deposit/quote"
payload = {
"source": {
"address": "0x1111111111111111111111111111111111111111",
"chain": 8453,
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"destination": {
"address": "0x2222222222222222222222222222222222222222",
"chain": 42161,
"token": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
},
"amount": "5000000",
"method": "crypto"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source: {
address: '0x1111111111111111111111111111111111111111',
chain: 8453,
token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
},
destination: {
address: '0x2222222222222222222222222222222222222222',
chain: 42161,
token: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
},
amount: '5000000',
method: 'crypto'
})
};
fetch('https://api.rheon.io/v1/deposit/quote', 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://api.rheon.io/v1/deposit/quote",
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([
'source' => [
'address' => '0x1111111111111111111111111111111111111111',
'chain' => 8453,
'token' => '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
],
'destination' => [
'address' => '0x2222222222222222222222222222222222222222',
'chain' => 42161,
'token' => '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
],
'amount' => '5000000',
'method' => 'crypto'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.rheon.io/v1/deposit/quote"
payload := strings.NewReader("{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.rheon.io/v1/deposit/quote")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rheon.io/v1/deposit/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}"
response = http.request(request)
puts response.read_body{
"environment": "sandbox",
"provider": "sprinter",
"outAmount": "4999750",
"validUntil": 1788799278,
"payload": "<unknown>",
"rheonCorridor": {
"sourceChain": 42161,
"destChain": 42161
},
"rheonTransfer": {
"fromAddress": "0x1111111111111111111111111111111111111111",
"toAddress": "0x1111111111111111111111111111111111111111",
"sourceChain": 42161,
"sourceToken": "0x1111111111111111111111111111111111111111",
"destChain": 42161,
"destToken": "0x1111111111111111111111111111111111111111",
"amount": "4980000",
"amountMode": "exact-in"
},
"rheonClient": "acme",
"rheonSig": "5cdc0af7861b267c45c0feec1cd2689278c94d70a53108c8c1226da055a6e25e",
"executionDurationSeconds": 123
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}Crypto deposits
Quote a cross-chain deposit
Prices a deposit for a source (wallet, chain, token), a destination (wallet, chain, token) and an amount. The answer is a signed quote: send the WHOLE object back, unchanged, to build the transaction.
POST
/
v1
/
deposit
/
quote
Quote a cross-chain deposit
curl --request POST \
--url https://api.rheon.io/v1/deposit/quote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": {
"address": "0x1111111111111111111111111111111111111111",
"chain": 8453,
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"destination": {
"address": "0x2222222222222222222222222222222222222222",
"chain": 42161,
"token": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
},
"amount": "5000000",
"method": "crypto"
}
'import requests
url = "https://api.rheon.io/v1/deposit/quote"
payload = {
"source": {
"address": "0x1111111111111111111111111111111111111111",
"chain": 8453,
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"destination": {
"address": "0x2222222222222222222222222222222222222222",
"chain": 42161,
"token": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
},
"amount": "5000000",
"method": "crypto"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source: {
address: '0x1111111111111111111111111111111111111111',
chain: 8453,
token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
},
destination: {
address: '0x2222222222222222222222222222222222222222',
chain: 42161,
token: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
},
amount: '5000000',
method: 'crypto'
})
};
fetch('https://api.rheon.io/v1/deposit/quote', 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://api.rheon.io/v1/deposit/quote",
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([
'source' => [
'address' => '0x1111111111111111111111111111111111111111',
'chain' => 8453,
'token' => '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
],
'destination' => [
'address' => '0x2222222222222222222222222222222222222222',
'chain' => 42161,
'token' => '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
],
'amount' => '5000000',
'method' => 'crypto'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.rheon.io/v1/deposit/quote"
payload := strings.NewReader("{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.rheon.io/v1/deposit/quote")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rheon.io/v1/deposit/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"source\": {\n \"address\": \"0x1111111111111111111111111111111111111111\",\n \"chain\": 8453,\n \"token\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"\n },\n \"destination\": {\n \"address\": \"0x2222222222222222222222222222222222222222\",\n \"chain\": 42161,\n \"token\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\"\n },\n \"amount\": \"5000000\",\n \"method\": \"crypto\"\n}"
response = http.request(request)
puts response.read_body{
"environment": "sandbox",
"provider": "sprinter",
"outAmount": "4999750",
"validUntil": 1788799278,
"payload": "<unknown>",
"rheonCorridor": {
"sourceChain": 42161,
"destChain": 42161
},
"rheonTransfer": {
"fromAddress": "0x1111111111111111111111111111111111111111",
"toAddress": "0x1111111111111111111111111111111111111111",
"sourceChain": 42161,
"sourceToken": "0x1111111111111111111111111111111111111111",
"destChain": 42161,
"destToken": "0x1111111111111111111111111111111111111111",
"amount": "4980000",
"amountMode": "exact-in"
},
"rheonClient": "acme",
"rheonSig": "5cdc0af7861b267c45c0feec1cd2689278c94d70a53108c8c1226da055a6e25e",
"executionDurationSeconds": 123
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}{
"environment": "sandbox",
"error": {
"code": "invalid_request",
"message": "amount must be a decimal string of the token's smallest unit.",
"fields": {
"applicantInfo.nationality": "iso3166_1_alpha2"
}
}
}Production, real money. This endpoint runs on live routes: the transaction you build moves real funds the moment the user signs it, and every hash you see is a real one. There is no crypto sandbox. Use a small amount to try it.
Authorizations
Your API key, issued by us and shown once at creation.
Body
application/json
Where the funds come from.
Show child attributes
Show child attributes
Where the funds go.
Show child attributes
Show child attributes
The amount, in the smallest unit of whichever token amountMode selects: the source token for exact-in, the destination token for target-out. Must be greater than zero.
Pattern:
^\d+$Example:
"5000000"
Funding method. Only "crypto" is supported on this route.
Allowed value:
"crypto"Which side amount pins down. exact-in (the default when omitted): the payer spends exactly amount of the source token. target-out: at least amount of the destination token must land, and the payer's side flexes. Any other value is refused rather than defaulted.
Available options:
exact-in, target-out Response
The signed quote.
A quote we issued. Send the WHOLE object back as quote, exactly as returned - every field is covered by the signature. The environment field every response starts with may come back with it; it is not part of the signature and is ignored on the way in.
Which environment answered. sandbox: at least one money upstream is the provider's sandbox - no real money moves there, and the card corridor is the sandbox's asset (read GET /v1/config), not the documented production one. production: every configured upstream is real. Derived from the configured upstream hosts at boot, never a flag.
Available options:
sandbox, production Example:
"sandbox"
Opaque identifier of the route source. Pass it back unchanged on /v1/deposit/status.
Example:
"sprinter"
Expected amount delivered at the destination, smallest unit of the destination token. Under target-out this is a FLOOR: bridges deliver at least this, usually a little more.
Pattern:
^\d+$Example:
"4999750"
Unix seconds after which the quote is refused with quote_expired. Set by us: at most five minutes from issue, or the provider's sooner deadline.
Required range:
-9007199254740991 <= x <= 9007199254740991Example:
1788799278
Opaque provider data needed to build the transaction. Do not inspect or modify; its shape differs per provider and is not a contract.
The chains this quote moves between, written by us and covered by the signature. Do not alter.
Show child attributes
Show child attributes
What was asked for, echoed by us (addresses lower-cased) and covered by the signature. Do not alter.
Show child attributes
Show child attributes
The API client this quote was issued to. A quote is only accepted back by the key it was issued to.
Example:
"acme"
Our signature over every other field. A quote that does not verify, or was altered anywhere, is refused.
Example:
"5cdc0af7861b267c45c0feec1cd2689278c94d70a53108c8c1226da055a6e25e"
How long the provider ESTIMATES the transfer takes, in seconds. Not a quote deadline. Absent when the provider does not state one.