Payouts

Get Quote

Get a quote for currency exchange to prepare a payout.

Request a real-time quote to convert between currencies before initiating a payout. The quote will lock in an exchange rate for a limited time period (typically 30 seconds) and can be used to create a payout with predictable conversion amounts.

Quotes are essential when you need to:

Convert crypto to fiat (e.g., USDC to INR or PHP)
Display exact amounts to users before confirmation
Ensure rate consistency between quote and execution

GET

payouts

quote

cURL

curl --request GET \
  --url https://api.example.com/v1/payouts/quote

import requests

url = "https://api.example.com/v1/payouts/quote"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/payouts/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.example.com/v1/payouts/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/payouts/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/v1/payouts/quote")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payouts/quote")

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

request = Net::HTTP::Get.new(url)

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

{
  "quoteId": "<string>",
  "object": "quote",
  "fromAsset": "<string>",
  "fromAmount": "<string>",
  "toAsset": "<string>",
  "toAmount": "<string>",
  "rate": "<string>",
  "feeBps": "<string>",
  "expiresAt": "<string>",
  "createdAt": "<string>"
}

Query Parameters

baseAsset

string

required

counterAsset

string

required

amount

string

required

type

enum<string>

required

Available options:

sell,

buy

Response

200 - application/json

The request has succeeded.

quoteId

string

required

object

enum<string>

default:quote

required

Available options:

quote

fromAsset

string

required

fromAmount

string

required

toAsset

string

required

toAmount

string

required

rate

string

required

feeBps

string

required

expiresAt

string

required

createdAt

string

required

List PayoutsList all payouts for your organization with pagination. Retrieve a paginated list of all payouts, sorted by creation date (newest first). Use pagination parameters to navigate through large result sets. Results can be filtered by various criteria including status, method, date range, and more. Each payout in the response includes its current status, amounts, and relevant details based on the payout method (crypto or fiat).

cURL

curl --request GET \
  --url https://api.example.com/v1/payouts/quote

import requests

url = "https://api.example.com/v1/payouts/quote"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/v1/payouts/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.example.com/v1/payouts/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/payouts/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/v1/payouts/quote")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payouts/quote")

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

request = Net::HTTP::Get.new(url)

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

{
  "quoteId": "<string>",
  "object": "quote",
  "fromAsset": "<string>",
  "fromAmount": "<string>",
  "toAsset": "<string>",
  "toAmount": "<string>",
  "rate": "<string>",
  "feeBps": "<string>",
  "expiresAt": "<string>",
  "createdAt": "<string>"
}