Create exchange

curl --request POST \
  --url https://api.vitawallet.io/api/businesses/transactions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'x-date: <api-key>' \
  --header 'x-login: <api-key>' \
  --header 'x-trans-key: <api-key>' \
  --data '
{
  "transactions_type": "exchange",
  "currency_sent": "usd",
  "currency_received": "usdt",
  "amount_sent": 10,
  "order": "AAA0008"
}
'

import requests

url = "https://api.vitawallet.io/api/businesses/transactions"

payload = {
    "transactions_type": "exchange",
    "currency_sent": "usd",
    "currency_received": "usdt",
    "amount_sent": 10,
    "order": "AAA0008"
}
headers = {
    "x-login": "<api-key>",
    "x-trans-key": "<api-key>",
    "x-date": "<api-key>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-login': '<api-key>',
    'x-trans-key': '<api-key>',
    'x-date': '<api-key>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    transactions_type: 'exchange',
    currency_sent: 'usd',
    currency_received: 'usdt',
    amount_sent: 10,
    order: 'AAA0008'
  })
};

fetch('https://api.vitawallet.io/api/businesses/transactions', 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.vitawallet.io/api/businesses/transactions",
  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([
    'transactions_type' => 'exchange',
    'currency_sent' => 'usd',
    'currency_received' => 'usdt',
    'amount_sent' => 10,
    'order' => 'AAA0008'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "x-date: <api-key>",
    "x-login: <api-key>",
    "x-trans-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://api.vitawallet.io/api/businesses/transactions"

	payload := strings.NewReader("{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}")

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

	req.Header.Add("x-login", "<api-key>")
	req.Header.Add("x-trans-key", "<api-key>")
	req.Header.Add("x-date", "<api-key>")
	req.Header.Add("Authorization", "<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://api.vitawallet.io/api/businesses/transactions")
  .header("x-login", "<api-key>")
  .header("x-trans-key", "<api-key>")
  .header("x-date", "<api-key>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vitawallet.io/api/businesses/transactions")

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

request = Net::HTTP::Post.new(url)
request["x-login"] = '<api-key>'
request["x-trans-key"] = '<api-key>'
request["x-date"] = '<api-key>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}"

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

{
  "id": "7b16a281-450c-40e9-978eedc17483-02273",
  "type": "business_transaction",
  "attributes": {
    "status": "completed",
    "origin_currency": "usd",
    "destination_currency": "usdt",
    "amount_sent": 10,
    "amount_received": 9.96,
    "rate": 0.9965,
    "order": "AAA000811",
    "created_at": "2026-04-28T18:51:13.188Z"
  }
}

Exchange

Create exchange

Create a crypto exchange transaction. This endpoint converts funds between a crypto and a fiat currency (in either direction) or between two cryptocurrencies, directly from your business wallet at the rate retrieved from GET /crypto_prices.

Note: This endpoint shares a URL with the other transaction creation flows (vita_sent, withdrawal, crypto_payout). The transactions_type field is the discriminator — set it to "exchange" for a crypto exchange.

Request Structure

Key	Description
`transactions_type`	Must be set to `"exchange"` for a crypto exchange.
`currency_sent`	Source currency to exchange from (e.g., `"usd"`, `"btc"`, `"usdt"`). Must be active in your wallet.
`currency_received`	Destination currency to exchange to (e.g., `"btc"`, `"usdt"`, `"usd"`).
`amount_sent`	Amount to exchange from the source currency (e.g., `100`, `105.65`).
`order`	Unique order identifier for this exchange transaction. Used as idempotency key.

Supported Exchange Types

Type	Direction
Fiat → Crypto	USD, CLP, COP, MXN, ARS → BTC, USDT, USDC
Crypto → Fiat	BTC, USDT, USDC → USD, CLP, COP, MXN, ARS
Crypto → Crypto	BTC ↔ USDT, BTC ↔ USDC, USDT ↔ USDC

⚠️ Not supported: Fiat → Fiat exchanges (e.g., USD → CLP, COP → MXN) are rejected with a 305 error. At least one of currency_sent or currency_received must be a cryptocurrency.

Important Considerations

Price Validity

Exchange rates come exclusively from GET /crypto_prices, which returns a valid_until timestamp.
If the price has expired when you submit, the API returns "Los precios han caducado, por favor intente de nuevo". Request /crypto_prices again before retrying.
The rate returned in the exchange response reflects the price used from the most recent /crypto_prices consultation.

Balance Requirements

Both the source and destination currencies must be active in your wallet.
The source balance must be enough to cover amount_sent.

Minimum Amount

Each currency_sent has a minimum exchange amount. Submitting below the minimum returns an error with min_exchange_amount and min_exchange_currency so you can present it to the end user.

Processing Time

Exchanges settle instantly once a valid price is confirmed.

Signature Coverage

All exchange parameters — including transactions_type — must be included in the signature validation.

Request Example

{
  "transactions_type": "exchange",
  "currency_sent": "usd",
  "currency_received": "usdt",
  "amount_sent": 10,
  "order": "AAA0008"
}

Quick Recap

Confirm crypto exchange is enabled on your business account.
Call GET /api/businesses/crypto_prices to retrieve the current _sell rate and valid_until.
Verify amount_sent meets the minimum for currency_sent and that your source balance covers it.
Make sure at least one of currency_sent / currency_received is a cryptocurrency.
Generate a unique order ID and submit the exchange to POST /api/businesses/transactions with transactions_type: "exchange" before valid_until expires.
If the response times out, query GET /api/businesses/transactions?order=<your_order> before retrying — never reuse the request with a new order.

POST

api

businesses

transactions

Create exchange

curl --request POST \
  --url https://api.vitawallet.io/api/businesses/transactions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'x-date: <api-key>' \
  --header 'x-login: <api-key>' \
  --header 'x-trans-key: <api-key>' \
  --data '
{
  "transactions_type": "exchange",
  "currency_sent": "usd",
  "currency_received": "usdt",
  "amount_sent": 10,
  "order": "AAA0008"
}
'

import requests

url = "https://api.vitawallet.io/api/businesses/transactions"

payload = {
    "transactions_type": "exchange",
    "currency_sent": "usd",
    "currency_received": "usdt",
    "amount_sent": 10,
    "order": "AAA0008"
}
headers = {
    "x-login": "<api-key>",
    "x-trans-key": "<api-key>",
    "x-date": "<api-key>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-login': '<api-key>',
    'x-trans-key': '<api-key>',
    'x-date': '<api-key>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    transactions_type: 'exchange',
    currency_sent: 'usd',
    currency_received: 'usdt',
    amount_sent: 10,
    order: 'AAA0008'
  })
};

fetch('https://api.vitawallet.io/api/businesses/transactions', 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.vitawallet.io/api/businesses/transactions",
  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([
    'transactions_type' => 'exchange',
    'currency_sent' => 'usd',
    'currency_received' => 'usdt',
    'amount_sent' => 10,
    'order' => 'AAA0008'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "x-date: <api-key>",
    "x-login: <api-key>",
    "x-trans-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://api.vitawallet.io/api/businesses/transactions"

	payload := strings.NewReader("{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}")

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

	req.Header.Add("x-login", "<api-key>")
	req.Header.Add("x-trans-key", "<api-key>")
	req.Header.Add("x-date", "<api-key>")
	req.Header.Add("Authorization", "<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://api.vitawallet.io/api/businesses/transactions")
  .header("x-login", "<api-key>")
  .header("x-trans-key", "<api-key>")
  .header("x-date", "<api-key>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vitawallet.io/api/businesses/transactions")

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

request = Net::HTTP::Post.new(url)
request["x-login"] = '<api-key>'
request["x-trans-key"] = '<api-key>'
request["x-date"] = '<api-key>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactions_type\": \"exchange\",\n  \"currency_sent\": \"usd\",\n  \"currency_received\": \"usdt\",\n  \"amount_sent\": 10,\n  \"order\": \"AAA0008\"\n}"

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

{
  "id": "7b16a281-450c-40e9-978eedc17483-02273",
  "type": "business_transaction",
  "attributes": {
    "status": "completed",
    "origin_currency": "usd",
    "destination_currency": "usdt",
    "amount_sent": 10,
    "amount_received": 9.96,
    "rate": 0.9965,
    "order": "AAA000811",
    "created_at": "2026-04-28T18:51:13.188Z"
  }
}

Authorizations

Business xLogin

x-trans-key

string

header

required

Business xTransKey

x-date

string

header

required

ISO8601 datetime

Authorization

string

header

required

V2-HMAC-SHA256 signature. Example: V2-HMAC-SHA256, Signature: <hash>

Body

application/json

transactions_type

enum<string>

required

Must be "exchange" for a crypto exchange transaction.

Available options:

exchange

currency_sent

string

required

Source currency (ISO code, lowercase). Must be active in your wallet.

Example:

"usd"

currency_received

string

required

Destination currency (ISO code, lowercase).

Example:

"usdt"

amount_sent

number

required

Amount to exchange from the source currency.

Example:

10

order

string

required

Unique order identifier (idempotency key).

Example:

"AAA0008"

Response

Exchange created successfully.

Payins

Exchange

Payouts

Transactions

Users

Webhooks

Create exchange

Request Structure

Supported Exchange Types

Important Considerations

Price Validity

Balance Requirements

Minimum Amount

Processing Time

Signature Coverage

Request Example

Quick Recap

Authorizations

Body

Response