# 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.

<mark style="color:green;">`POST`</mark> `https://api.oxapay.com/exchange/calculate`

#### Request Body

<table><thead><tr><th width="157">Name</th><th width="93">Type</th><th>Description</th></tr></thead><tbody><tr><td>fromCurrency<mark style="color:red;">*</mark></td><td>string</td><td>The <a href="/pages/J7efulCOZC0zGKzpVHol">currency</a> code of the cryptocurrency you want to convert from</td></tr><tr><td>toCurrency<mark style="color:red;">*</mark></td><td>string</td><td>The <a href="/pages/J7efulCOZC0zGKzpVHol">currency</a> code of the cryptocurrency you want to convert to</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>decimal</td><td>Amount you want to exchange</td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK " %}

```json
{
  "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.
}
```

{% endtab %}
{% endtabs %}

### Example codes

{% tabs %}
{% tab title="cURL" %}

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

{% endtab %}

{% tab title="PHP" %}

```php
<?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);
?>
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
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);
  });
```

{% endtab %}

{% tab title="Python" %}

```python
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)
```

{% endtab %}
{% endtabs %}

### 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.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oxapay.com/legacy/api-reference/exchange-calculate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.