OxaPay Docs
Legacy
Legacy
  • Introduction
  • Getting Started
  • Integrations
    • Payment Links
    • Donations
    • Merchant API
    • Payout API
    • Plugins
      • WooCommerce
      • WISECP
      • Clientexec
      • Blesta
      • WHMCS
      • PrestaShop
      • Easy Digital Downloads
      • Paid Memberships Pro
      • Gravity Forms
      • Restrict Content Pro
    • Merchant and Payout Service with API
  • API Reference
    • Creating an Invoice
    • Creating White-Label Payment
    • Creating Static Wallet
    • Revoking Static Wallet
    • Static Wallets List
    • Payment Information
    • Payment History
    • Accepted Coins
    • Price
    • Creating Payout
    • Payout Information
    • Payout History
    • Account Balance
    • Exchange Rate
    • Exchange Calculate
    • Exchange Pairs
    • Exchange Request
    • Exchange History
    • Supported Currencies
    • Supported Fiat Currencies
    • Supported Networks
    • System Status
    • Result code table
    • Merchant status table
    • Payout status table
  • Webhook
  • Use Cases
  • Troubleshooting
Powered by GitBook
On this page
  • Example codes
  • Usage
  1. API Reference

Exchange Calculate

This endpoint helps you instantly know how much cryptocurrency you'll get when exchanging from one type to another. Perfect for anyone interested in cryptocurrency, this feature is super easy to use. Just plug it into your app, and you'll always have the latest exchange rates at your fingertips. Whether you're buying or selling, the endpoint makes it simple to calculate the amount you'll receive in your desired cryptocurrency.

POST https://api.oxapay.com/exchange/calculate

Request Body

Name
Type
Description

fromCurrency*

string

toCurrency*

string

amount*

decimal

Amount you want to exchange

{
  "result": integer, // The result code indicates the success or failure of the request.
  "message": string, // A message providing additional information about the result.
  "rate": string, // The real-time exchange rate representing the number of units of `fromCurrency` equivalent to `toCurrency`.
  "amount": string, // The amount you want to exchange
  "toAmount": string // The amount you'll receive in your desired cryptocurrency.
}

Example codes

curl -X POST https://api.oxapay.com/exchange/calculate \
     -d '{
          "amount": 12,
          "fromCurrency": "USDT",
          "toCurrency": "TRX"
      }'
<?php

$url = "https://api.oxapay.com/exchange/calculate";

$data = array(
    "amount" => 12,
    "fromCurrency" => "USDT",
    "toCurrency" => "TRX"
);

$options = array(
    'http' => array(
        'header' => 'Content-Type: application/json',
        'method'  => 'POST',
        'content' => json_encode($data),
    ),
);

$context  = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result = json_decode($response);
var_dump($result);
?>
const axios = require('axios');
const url = 'https://api.oxapay.com/exchange/calculate';
const data = JSON.stringify({
  amount: 12,
  fromCurrency: 'USDT',
  toCurrency: 'TRX'
});

axios.post(url, data)
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error:', error);
  });
import requests
import json

url = 'https://api.oxapay.com/exchange/calculate'
data = {
    'amount': 12,
    'fromCurrency': 'USDT',
    'toCurrency': 'TRX'
}
response = requests.post(url, data=json.dumps(data))
result = response.json()
print(result)

Usage

By inputting the amount, fromCurrency, and toCurrency parameters, you can instantly fetch the exchange rate between your chosen cryptocurrencies and determine the amount in your desired currency. For instance, if you specify an amount of 0.2 with fromCurrency set to "BTC" and toCurrency set to "USDT," the response will furnish the current BTC to USDT rate, along with the corresponding amount of USDT you'll receive after exchanging the specified BTC quantity. This feature simplifies the process of calculating cryptocurrency exchanges, providing real-time insights for informed decision-making.

Please note that the exchange rate provided in the response may fluctuate over time due to the volatile nature of cryptocurrency markets.

PreviousExchange RateNextExchange Pairs

Last updated 4 months ago

The code of the cryptocurrency you want to convert from

The code of the cryptocurrency you want to convert to

currency
currency