Swap Pairs

This endpoint allows you to access a list of swappable cryptocurrencies along with their minimum swap amounts. It provides the available options for the from_currency and to_currency fields when performing cryptocurrency swaps. Whether you're swapping Bitcoin for Tether or Tether for Litecoin, this list ensures clarity on supported pairs and their minimum swap requirements, helping you plan seamless transactions.

GET https://api.oxapay.com/v1/general/swap/pairs

Authentication

You must include the General API Key in the request header to authenticate your access to the API.

Name	Type	Description
general_api_key*	string	Your General API Key for authentication and authorization.

200: OK

{
  "data": {
    "list": 
      {
        "from_currency": string, // The currency being swapped from, e.g., 'BTC' (Bitcoin).
        "to_currency": string, // The currency being swapped to, e.g., 'USDT' (Tether).
        "min_amount": decimal // The minimum amount of the "from_currency" required for the swap, represented with high precision (e.g., 0.01 BTC).
      }[],
    "meta": {
      "page": integer, // The current page number of the result set.
      "last_page": integer, // The total number of pages available based on the number of records and page size.
      "total": integer // The total number of payments available for the specified criteria.
    },
  },
  "message": string,  // A message containing additional information about the result of the request.
  "error": {
      "type": string, 
      "key": string, 
      "message": string 
  } || {}, // An object that provides details about any errors that occurred.
  "status": integer, // The status of the request response. Typically provided as a numeric code (e.g., 200 for success or other codes for errors).
  "version": string // The version of the API being used.
}

Please note that a successful request will return status 200. In case of any issues or validation problems, refer to the corresponding error for further details.

API Request Sample Codes

cURL

curl -X GET https://api.oxapay.com/v1/general/swap/pairs \
  -H "general_api_key: YOUR_GENERAL_API_KEY" \
  -H "Content-Type: application/json" 

PHP

<?php

$url = 'https://api.oxapay.com/v1/general/swap/pairs';

$headers = [
    'Content-Type: application/json',
    'general_api_key: YOUR_GENERAL_API_KEY'
];

$options = array(
    'http' => array(
        'header'  => implode("\r\n", $headers),
        'method'  => 'GET'
    ),
);

$context  = stream_context_create($options);
$response = file_get_contents($url, false, $context);
if ($response === FALSE) {
    die('Error occurred');
}

$result = json_decode($response, true);
var_dump($result);

?>

Node.js

const axios = require('axios');

const url = 'https://api.oxapay.com/v1/general/swap/pairs';

const headers = {
  'general_api_key': `YOUR_GENERAL_API_KEY`,
  'Content-Type': 'application/json',
};

axios.get(url, { headers })
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error);
  });
  

Python

import requests

url = 'https://api.oxapay.com/v1/general/swap/pairs'

headers = {
    'general_api_key': 'YOUR_GENERAL_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
result = response.json()
print(result)

These example code snippets demonstrate how to request the "Swap Calculate" endpoint using different programming languages. You can customize the data parameters according to your specific requirements.

Please make sure to replace YOUR_GENERAL_API_KEY in the code snippets with your actual General API Key.

API Response Example

{
    "data":{
        "list": [
            { "fromCurrency": "BTC", "toCurrency": "USDT", "minAmount": 0.0003 }, 
            { "fromCurrency": "ETH", "toCurrency": "USDT", "minAmount": 0.005 }, 
            { "fromCurrency": "BNB", "toCurrency": "USDT", "minAmount": 0.01 }, 
            { "fromCurrency": "LTC", "toCurrency": "USDT", "minAmount": 0.05 }, 
            { "fromCurrency": "TRX", "toCurrency": "USDT", "minAmount": 1 }, 
            { "fromCurrency": "DOGE", "toCurrency": "USDT", "minAmount": 1 }, 
            { "fromCurrency": "MATIC", "toCurrency": "USDT", "minAmount": 0.1 }, 
            { "fromCurrency": "TON", "toCurrency": "USDT", "minAmount": 0.1 }, 
            { "fromCurrency": "XMR", "toCurrency": "USDT", "minAmount": 0.01 }, 
            { "fromCurrency": "BCH", "toCurrency": "USDT", "minAmount": 0.005 }, 
            { "fromCurrency": "SHIB", "toCurrency": "USDT", "minAmount": 100000 }, 
            { "fromCurrency": "SOL", "toCurrency": "USDT", "minAmount": 0.008 }, 
            { "fromCurrency": "USDT", "toCurrency": "BTC", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "ETH", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "BNB", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "LTC", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "TRX", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "DOGE", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "MATIC", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "TON", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "XMR", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "BCH", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "SHIB", "minAmount": 1 }, 
            { "fromCurrency": "USDT", "toCurrency": "SOL", "minAmount": 1 }
        ]
    },
    "message": "Operation completed successfully!",
    "error": {},
    "status": 200,
    "version": "1.0.0"
}

The response example above is provided to help you understand the format and structure of the response. If you have any further questions or need assistance, please feel free to contact to your account manager.