transactions - Create a swap promise (quote)

curl --request POST \
  --url https://api.ripio.com/wallet/transactions/quotes/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "from_currency": "ARS",
  "to_currency": "BTC",
  "amount_currency": "ARS",
  "amount": "10000",
  "gateway": "balance"
}
'

import requests

url = "https://api.ripio.com/wallet/transactions/quotes/"

payload = {
    "from_currency": "ARS",
    "to_currency": "BTC",
    "amount_currency": "ARS",
    "amount": "10000",
    "gateway": "balance"
}
headers = {
    "authorization": "<authorization>",
    "signature": "<signature>",
    "timestamp": "<timestamp>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    authorization: '<authorization>',
    signature: '<signature>',
    timestamp: '<timestamp>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from_currency: 'ARS',
    to_currency: 'BTC',
    amount_currency: 'ARS',
    amount: '10000',
    gateway: 'balance'
  })
};

fetch('https://api.ripio.com/wallet/transactions/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://api.ripio.com/wallet/transactions/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([
    'from_currency' => 'ARS',
    'to_currency' => 'BTC',
    'amount_currency' => 'ARS',
    'amount' => '10000',
    'gateway' => 'balance'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>",
    "signature: <signature>",
    "timestamp: <timestamp>"
  ],
]);

$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.ripio.com/wallet/transactions/quotes/"

	payload := strings.NewReader("{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}")

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

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("signature", "<signature>")
	req.Header.Add("timestamp", "<timestamp>")
	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.ripio.com/wallet/transactions/quotes/")
  .header("authorization", "<authorization>")
  .header("signature", "<signature>")
  .header("timestamp", "<timestamp>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ripio.com/wallet/transactions/quotes/")

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

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["signature"] = '<signature>'
request["timestamp"] = '<timestamp>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}"

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

{
  "error_code": "<string>",
  "message": "<string>",
  "data": {
    "uuid": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "from_currency": "ARS",
    "to_currency": "BTC",
    "rate": "0.000000005742",
    "amount_from": "10000.00",
    "amount_to": "0.00005741",
    "currency_pair": "ARS_BTC",
    "expires_at": "2026-04-13T12:02:00.000000Z",
    "expires_in": 120,
    "from_currency_id": 1,
    "to_currency_id": 2,
    "inverted_rate": "174155346.57",
    "rate_usd": "0.0255102",
    "amount_usd": "255.10",
    "alt_currency_pair": null,
    "fee": null,
    "fee_currency": null,
    "alt_fee": null,
    "action": "SWAP",
    "created_at": "2026-04-13T12:00:00.000000Z"
  }
}

"<string>"

"<string>"

"<string>"

"<string>"

Transactions

Create A Swap Promise (quote)

Creates a swap promise for a currency pair. A promise is a short-lived signed quote (JWT) returned in the uuid field that must be sent back to POST /transactions/swap/ to execute the swap before it expires.

The swap can be fiat-to-crypto, crypto-to-fiat or crypto-to-crypto. The amount can be expressed either in from_currency or in to_currency, indicated by amount_currency.

The pair must be enabled for swap for the account (currency availability and per-account rollout apply); otherwise a 409 is returned.

How to obtain the required values:

from_currency / to_currency: enabled swap currencies for the account’s country.
amount_currency: must equal from_currency or to_currency.
gateway: use "balance" for the balance swap.

Authorization

Requires a valid API key.

POST

wallet

transactions

quotes

transactions - Create a swap promise (quote)

curl --request POST \
  --url https://api.ripio.com/wallet/transactions/quotes/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "from_currency": "ARS",
  "to_currency": "BTC",
  "amount_currency": "ARS",
  "amount": "10000",
  "gateway": "balance"
}
'

import requests

url = "https://api.ripio.com/wallet/transactions/quotes/"

payload = {
    "from_currency": "ARS",
    "to_currency": "BTC",
    "amount_currency": "ARS",
    "amount": "10000",
    "gateway": "balance"
}
headers = {
    "authorization": "<authorization>",
    "signature": "<signature>",
    "timestamp": "<timestamp>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    authorization: '<authorization>',
    signature: '<signature>',
    timestamp: '<timestamp>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from_currency: 'ARS',
    to_currency: 'BTC',
    amount_currency: 'ARS',
    amount: '10000',
    gateway: 'balance'
  })
};

fetch('https://api.ripio.com/wallet/transactions/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://api.ripio.com/wallet/transactions/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([
    'from_currency' => 'ARS',
    'to_currency' => 'BTC',
    'amount_currency' => 'ARS',
    'amount' => '10000',
    'gateway' => 'balance'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>",
    "signature: <signature>",
    "timestamp: <timestamp>"
  ],
]);

$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.ripio.com/wallet/transactions/quotes/"

	payload := strings.NewReader("{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}")

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

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("signature", "<signature>")
	req.Header.Add("timestamp", "<timestamp>")
	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.ripio.com/wallet/transactions/quotes/")
  .header("authorization", "<authorization>")
  .header("signature", "<signature>")
  .header("timestamp", "<timestamp>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ripio.com/wallet/transactions/quotes/")

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

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["signature"] = '<signature>'
request["timestamp"] = '<timestamp>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_currency\": \"ARS\",\n  \"to_currency\": \"BTC\",\n  \"amount_currency\": \"ARS\",\n  \"amount\": \"10000\",\n  \"gateway\": \"balance\"\n}"

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

{
  "error_code": "<string>",
  "message": "<string>",
  "data": {
    "uuid": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "from_currency": "ARS",
    "to_currency": "BTC",
    "rate": "0.000000005742",
    "amount_from": "10000.00",
    "amount_to": "0.00005741",
    "currency_pair": "ARS_BTC",
    "expires_at": "2026-04-13T12:02:00.000000Z",
    "expires_in": 120,
    "from_currency_id": 1,
    "to_currency_id": 2,
    "inverted_rate": "174155346.57",
    "rate_usd": "0.0255102",
    "amount_usd": "255.10",
    "alt_currency_pair": null,
    "fee": null,
    "fee_currency": null,
    "alt_fee": null,
    "action": "SWAP",
    "created_at": "2026-04-13T12:00:00.000000Z"
  }
}

"<string>"

"<string>"

"<string>"

"<string>"

Headers

authorization

string

required

The API key as a string.

signature

string

required

See the Generating Signature section for more details.

timestamp

number

required

A timestamp in milliseconds. See the Timestamp Security section for more details.

timstamp-tolerance

number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json

from_currency

string

required

Currency ticker to swap from.

Example:

"ARS"

to_currency

string

required

Currency ticker to swap to.

Example:

"BTC"

amount_currency

string

required

Currency in which amount is expressed. Must equal from_currency or to_currency.

Example:

"ARS"

amount

string

required

Amount to swap as a decimal string, expressed in amount_currency.

Example:

"10000"

gateway

string

required

Gateway identifier for the swap.

Example:

"balance"

Response

Swap promise created successfully.

error_code

string

message

string

data

object

Swap promise (quote) returned by the promises endpoint. The uuid is a signed token (JWT) that must be sent to POST /transactions/swap/ to execute the swap before it expires.

Show child attributes

Send Balance To Another User Via Ripio_tag Execute A Balance Swap From A Promise

⌘I

Introduction

Ripio Wallet

Ripio Trade

Create A Swap Promise (quote)

Headers

Body

Response