Ramp Orders

Create Ramp (Receive Based)

By consuming this endpoint you will be able to create a new ramp for converting your assets.

Headers

Field	Type	Required	Description
Authorization	Header	Yes	The access token, valid for 5 minutes, is used to authenticate requests to other endpoints.
clientId	Query	Yes	Include your assigned ID in the URL, obtainable through the Get infoClient endpoint.
idempotency-key	UUID	No	A unique key that prevents duplicate execution of the same request in case of retries.

Request Body

Field	Description
assetIn	The symbol of the asset you will send (COP, MXN, USD, USDC, USDT)
assetOut	The symbol of the asset you want to receive (COP, MXN, USD, USDC, USDT).
amountOut	This is the amount that we will send and you will receive as a result of your operation.
accountOriginId	The unique ID of your origin Wallet/ Bank Account you selected as the origin for the ramp you are creating. You can obtain the ID using the Get /wallets or Get /accounts endpoint. Please make sure the account status is approved.
accountDestinationId	The unique ID of your Wallet/Bank Account you selected as the destination for the ramp you are creating. You can obtain the ID using the Get /wallets or Get /accounts endpoint. Please make sure the account status is approved.
paymentMethod	Optional. Applies to ramps involving COP (typically STABLE/COP). Allowed values: pse, bank_transfer, DAVIPLATA, NEQUI or breb. Defaults to bank_transfer when omitted. Use breb to pay or receive COP through Colombia’s Bre-B instant payment network. Requires a registered bank account of type breb. Fiat side must always be COP.
transactionPurpose	The purpose or reason for the transaction. This field is used to provide context about the origin of funds or the intent of the transfer

Response Body

The response will include the status of the request and any relevant data related to the order created.

Field	Description
Id	This is your ramp unique identifier.
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).
amountSent	This is the amount you will operate and send to us.
numberRamp	This is your ramp tracking number.
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).
registerDate	This is the date when you created your ramp with us.
status	The status of the ramp. It can be: “pending”: Awaiting proof of funds transfer., “payapproved”: Funds received and approved, “payrejected”: The funds transfer does not meet our requirements, “completed”: Transaction successfully completed. “cancelled”: Ramp expired without completion.
amountToReceive	This is the amount that we will send and you will receive as a result of your operation.
costInfra	This is the infrastructure use cost applied to your transaction.
rateClient	This is the 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, COPM).
withdrawalFee	Withdrawal costs related to the transaction.
validUntil	This is your ramp’s validity period. Format `YYYY-MM-DD HH:MM:SS.ffffff`; the ramp expires 10 minutes after creation.
accountDestination	Deposit instructions indicating where you should send the funds.

The clientId query parameter is required: requests without it are rejected with 401.

POST

api

inverse

ramp

Create Ramp (Receive Based)

curl --request POST \
  --url https://testapi.kravata.co/api/inverse/ramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetIn": "COP",
  "assetOut": "USDC",
  "amountOut": 12,
  "accountOriginId": "{{accountOriginId}}",
  "accountDestinationId": "{{accountDestinationId}}",
  "transactionPurpose": ""
}
'

import requests

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

payload = {
    "assetIn": "COP",
    "assetOut": "USDC",
    "amountOut": 12,
    "accountOriginId": "{{accountOriginId}}",
    "accountDestinationId": "{{accountDestinationId}}",
    "transactionPurpose": ""
}
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({
    assetIn: 'COP',
    assetOut: 'USDC',
    amountOut: 12,
    accountOriginId: '{{accountOriginId}}',
    accountDestinationId: '{{accountDestinationId}}',
    transactionPurpose: ''
  })
};

fetch('https://testapi.kravata.co/api/inverse/ramp', 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",
  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([
    'assetIn' => 'COP',
    'assetOut' => 'USDC',
    'amountOut' => 12,
    'accountOriginId' => '{{accountOriginId}}',
    'accountDestinationId' => '{{accountDestinationId}}',
    'transactionPurpose' => ''
  ]),
  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"

	payload := strings.NewReader("{\n  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\n}"

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

{
  "id": "76cc6491-4637-48f1-bdb5-070a5ff78be5",
  "numberRamp": "0012345",
  "rampType": "on_ramp",
  "symbolTypeSent": "COP",
  "symbolTypeReceived": "USDC",
  "amountSent": 52780.4,
  "amountReceived": 12,
  "bankAccountId": "0601cb0f-7b99-4d04-9b56-d0524a8f281d",
  "operationCategory": "ramp",
  "status": "pending",
  "registerDate": "2026-09-30 10:15:02.123456",
  "validUntil": "2026-09-30 10:25:02.123456",
  "rampMonetary": [
    {
      "rateClient": 4398.2,
      "operationConcept": "Rate"
    },
    {
      "costInfra": 3200,
      "operationConcept": "Cost"
    }
  ],
  "accountDestination": [
    [
      {
        "sku": "accountNumber",
        "concept": "Account number",
        "value": "123456789",
        "visibility": true
      }
    ]
  ],
  "walletDestination": [],
  "userId": "08597c65-c25b-4a7c-8c68-f1180bce65f4",
  "walletId": "d5a3b243-db5b-46c7-b4ce-8e2b88a72122",
  "originUserId": "08597c65-c25b-4a7c-8c68-f1180bce65f4",
  "destinationUserId": "08597c65-c25b-4a7c-8c68-f1180bce65f4"
}

Authorizations

Authorization

string

header

required

Access token from POST /api/token (valid 5 minutes).

Query Parameters

clientId

string

required

Body

application/json

assetIn

string

assetOut

string

amountOut

integer

accountOriginId

string

accountDestinationId

string

transactionPurpose

string

Response

200 - application/json

string

numberRamp

string

rampType

string

symbolTypeSent

string

symbolTypeReceived

string

amountSent

number

amountReceived

number

bankAccountId

string

operationCategory

string

status

string

registerDate

string

validUntil

string

rampMonetary

object[]

Show child attributes

accountDestination

object[][]

Show child attributes

walletDestination

any[]

userId

string

walletId

string

originUserId

string

destinationUserId

string

Create Ramp (Receive Based)

curl --request POST \
  --url https://testapi.kravata.co/api/inverse/ramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetIn": "COP",
  "assetOut": "USDC",
  "amountOut": 12,
  "accountOriginId": "{{accountOriginId}}",
  "accountDestinationId": "{{accountDestinationId}}",
  "transactionPurpose": ""
}
'

import requests

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

payload = {
    "assetIn": "COP",
    "assetOut": "USDC",
    "amountOut": 12,
    "accountOriginId": "{{accountOriginId}}",
    "accountDestinationId": "{{accountDestinationId}}",
    "transactionPurpose": ""
}
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({
    assetIn: 'COP',
    assetOut: 'USDC',
    amountOut: 12,
    accountOriginId: '{{accountOriginId}}',
    accountDestinationId: '{{accountDestinationId}}',
    transactionPurpose: ''
  })
};

fetch('https://testapi.kravata.co/api/inverse/ramp', 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",
  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([
    'assetIn' => 'COP',
    'assetOut' => 'USDC',
    'amountOut' => 12,
    'accountOriginId' => '{{accountOriginId}}',
    'accountDestinationId' => '{{accountDestinationId}}',
    'transactionPurpose' => ''
  ]),
  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"

	payload := strings.NewReader("{\n  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"assetIn\": \"COP\",\n  \"assetOut\": \"USDC\",\n  \"amountOut\": 12,\n  \"accountOriginId\": \"{{accountOriginId}}\",\n  \"accountDestinationId\": \"{{accountDestinationId}}\",\n  \"transactionPurpose\": \"\"\n}"

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

{
  "id": "76cc6491-4637-48f1-bdb5-070a5ff78be5",
  "numberRamp": "0012345",
  "rampType": "on_ramp",
  "symbolTypeSent": "COP",
  "symbolTypeReceived": "USDC",
  "amountSent": 52780.4,
  "amountReceived": 12,
  "bankAccountId": "0601cb0f-7b99-4d04-9b56-d0524a8f281d",
  "operationCategory": "ramp",
  "status": "pending",
  "registerDate": "2026-09-30 10:15:02.123456",
  "validUntil": "2026-09-30 10:25:02.123456",
  "rampMonetary": [
    {
      "rateClient": 4398.2,
      "operationConcept": "Rate"
    },
    {
      "costInfra": 3200,
      "operationConcept": "Cost"
    }
  ],
  "accountDestination": [
    [
      {
        "sku": "accountNumber",
        "concept": "Account number",
        "value": "123456789",
        "visibility": true
      }
    ]
  ],
  "walletDestination": [],
  "userId": "08597c65-c25b-4a7c-8c68-f1180bce65f4",
  "walletId": "d5a3b243-db5b-46c7-b4ce-8e2b88a72122",
  "originUserId": "08597c65-c25b-4a7c-8c68-f1180bce65f4",
  "destinationUserId": "08597c65-c25b-4a7c-8c68-f1180bce65f4"
}

Guides

API reference

Create Ramp (Receive Based)

Headers

Request Body

Response Body

Authorizations

Query Parameters

Body

Response