Ramp Orders

Quote Ramp (Receive Based)

By consuming this endpoint you can calculate the ramp details by providing the desired parameters. The response body will show the calculated ramp details based on them.

Request Body

Field	Type	Required	Description
`amountReceive`	float	Yes	This is the amount that we will send and you will receive as a result of your operation. This value will be used to calculate the required amount to send.
`rampType`	string	Yes	The type of order/ ramp you will create (“on_ramp”: if you have Fiat and want to receive Stable Coin; “off_ramp”: if you have Stable Coin and want to receive Fiat).
`symbolTypeSent`	string	Yes	The symbol of the token/fiat you will send us (COP, MXN, USD, USDC, USDT).
`symbolTypeReceived`	string	Yes	The symbol of the token/fiat we will send you (COP, MXN, USD, USDC, USDT).
`network`	string	Yes	The network used for the transaction Allowed values: SUI, TRC20, ERC20 , POLYGON , SOLANA, CELO).
`clientId`	string	Yes	Your unique client identifier, obtainable via the `Get infoClient` endpoint.

Response

The response is a JSON object representing the quote for the transaction, including costs and expected values.

Field	Description
`amountSent`	This is the amount you will operate and send to us.
`amountToReceive`	This is the amount that we will send and you will receive as a result of your operation. (matches the input `amountReceive`).
`costInfra`	This is the infrastructure use cost applied to your transaction
`rateClient`	The exchange rate applied to calculate the transaction.
`symbolTypeSent`	The symbol of the token/fiat you will send us (COP, MXN, USD, USDC, USDT).
`symbolTypeReceived`	The symbol of the token/fiat we will send you (COP, MXN, USD, USDC, USDT).
`withdrawalFee`	Withdrawal costs related to the transaction.
`rampType`	The type of order/ ramp you will create (“on_ramp”: if you have Fiat and want to receive Stable Coin; “off_ramp”: if you have Stable Coin and want to receive Fiat).
`validUntil`	This is your quote’s validity period. Time is expressed in UTC.

The response also includes quoteId. Send it when creating the ramp to lock this quote; it can be used only once and only until validUntil (30 seconds by default). Fields whose value is zero are omitted from the response.

POST

api

inverse

ramp

calculate

Quote Ramp (Receive Based)

curl --request POST \
  --url https://testapi.kravata.co/api/inverse/ramp/calculate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountReceive": 1000,
  "rampType": "on_ramp",
  "symbolTypeSent": "COP",
  "symbolTypeReceived": "USDC",
  "network": "POLYGON",
  "clientId": "{{clientId}}"
}
'

import requests

url = "https://testapi.kravata.co/api/inverse/ramp/calculate"

payload = {
    "amountReceive": 1000,
    "rampType": "on_ramp",
    "symbolTypeSent": "COP",
    "symbolTypeReceived": "USDC",
    "network": "POLYGON",
    "clientId": "{{clientId}}"
}
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({
    amountReceive: 1000,
    rampType: 'on_ramp',
    symbolTypeSent: 'COP',
    symbolTypeReceived: 'USDC',
    network: 'POLYGON',
    clientId: '{{clientId}}'
  })
};

fetch('https://testapi.kravata.co/api/inverse/ramp/calculate', 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://testapi.kravata.co/api/inverse/ramp/calculate",
  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([
    'amountReceive' => 1000,
    'rampType' => 'on_ramp',
    'symbolTypeSent' => 'COP',
    'symbolTypeReceived' => 'USDC',
    'network' => 'POLYGON',
    'clientId' => '{{clientId}}'
  ]),
  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://testapi.kravata.co/api/inverse/ramp/calculate"

	payload := strings.NewReader("{\n  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\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://testapi.kravata.co/api/inverse/ramp/calculate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://testapi.kravata.co/api/inverse/ramp/calculate")

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  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\n}"

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

{
  "amountReceive": 1000,
  "amountSent": 4412880.5,
  "costInfra": 3200,
  "rateClient": 4398.2,
  "feeGMF": 17651.5,
  "rampType": "on_ramp",
  "symbolTypeReceived": "USDC",
  "symbolTypeSent": "COP",
  "quoteId": "3f2b8f7e-6c1d-4a7e-9b1e-2d4c5a6b7c8d",
  "validUntil": "2026-09-30T15:04:35.123456Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

amountReceive

integer

rampType

string

symbolTypeSent

string

symbolTypeReceived

string

network

string

clientId

string

Response

200 - application/json

amountReceive

integer

amountSent

number

costInfra

number

rateClient

number

feeGMF

number

rampType

string

symbolTypeReceived

string

symbolTypeSent

string

quoteId

string

validUntil

string

Quote Ramp (Receive Based)

curl --request POST \
  --url https://testapi.kravata.co/api/inverse/ramp/calculate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountReceive": 1000,
  "rampType": "on_ramp",
  "symbolTypeSent": "COP",
  "symbolTypeReceived": "USDC",
  "network": "POLYGON",
  "clientId": "{{clientId}}"
}
'

import requests

url = "https://testapi.kravata.co/api/inverse/ramp/calculate"

payload = {
    "amountReceive": 1000,
    "rampType": "on_ramp",
    "symbolTypeSent": "COP",
    "symbolTypeReceived": "USDC",
    "network": "POLYGON",
    "clientId": "{{clientId}}"
}
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({
    amountReceive: 1000,
    rampType: 'on_ramp',
    symbolTypeSent: 'COP',
    symbolTypeReceived: 'USDC',
    network: 'POLYGON',
    clientId: '{{clientId}}'
  })
};

fetch('https://testapi.kravata.co/api/inverse/ramp/calculate', 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://testapi.kravata.co/api/inverse/ramp/calculate",
  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([
    'amountReceive' => 1000,
    'rampType' => 'on_ramp',
    'symbolTypeSent' => 'COP',
    'symbolTypeReceived' => 'USDC',
    'network' => 'POLYGON',
    'clientId' => '{{clientId}}'
  ]),
  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://testapi.kravata.co/api/inverse/ramp/calculate"

	payload := strings.NewReader("{\n  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\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://testapi.kravata.co/api/inverse/ramp/calculate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://testapi.kravata.co/api/inverse/ramp/calculate")

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  \"amountReceive\": 1000,\n  \"rampType\": \"on_ramp\",\n  \"symbolTypeSent\": \"COP\",\n  \"symbolTypeReceived\": \"USDC\",\n  \"network\": \"POLYGON\",\n  \"clientId\": \"{{clientId}}\"\n}"

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

{
  "amountReceive": 1000,
  "amountSent": 4412880.5,
  "costInfra": 3200,
  "rateClient": 4398.2,
  "feeGMF": 17651.5,
  "rampType": "on_ramp",
  "symbolTypeReceived": "USDC",
  "symbolTypeSent": "COP",
  "quoteId": "3f2b8f7e-6c1d-4a7e-9b1e-2d4c5a6b7c8d",
  "validUntil": "2026-09-30T15:04:35.123456Z"
}

Guides

API reference

Quote Ramp (Receive Based)

Request Body

Response

Authorizations

Body

Response