# Crypto Exchange Endpoint

## Crypto Exchange Endpoint

<mark style="color:blue;">`GET`</mark> `https://api-stg.directa24.com/v3/exchange_rates/crypto?currency={currency}&amount={amount}&crypto={crypto}`

The Crypto Exchange endpoint allows you to get the exchange of any crypto currency compared against USD or any other local currency.

#### Query Parameters

| Name     | Type   | Description                                                                                                                   |
| -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| currency | string | USD or the country's local currency that will be used by the payer                                                            |
| amount   | number | Amount in the previously specified currency. Used to calculate the exchange in the cryptocurrency specified below. Default: 1 |
| crypto   | string | Cryptocurrency symbol in which the amount will be converted to                                                                |

#### Headers

| Name          | Type   | Description                   |
| ------------- | ------ | ----------------------------- |
| Authorization | string | "Bearer " + Read-Only API Key |

{% tabs %}
{% tab title="200 Currency exchange correctly returned." %}

```java
{
  "fx_rate": 5.8829,
  "converted_amount": 58.829,
  "fee": 0.64
}
```

{% endtab %}

{% tab title="401 Invalid credentials error" %}

```java
{
    "code": 100,
    "description": "Invalid credentials"
}
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
Please find all the country and currencies codes in the [Countries Specifications](https://docs.pandablue.com/specifications/countries-specifications#details) section.
{% endhint %}

## Description

The **Crypto Exchange Endpoint** allows you to convert any amount in USD or Local Currency to the specified Cryptocurrency.

## Request

In order to start using the Crypto Exchange endpoint, you need to:

1. Send the request with **GET** method.
2. Specify a [valid currency code](https://docs.pandablue.com/specifications/countries-specifications#countries-and-currencies) in the request as **QUERY PARAMS**.
3. Specify the amount to convert.\* If it's not specified, 1 is assumed.
4. Specify a valid cryptocurrency symbol that will be converted the amount to.
5. Send the **Authorization** header with your read-only API Key as Bearer as follows:

> Authorization: Bearer *your\_read\_only\_key\_here*

### Example request

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

```bash
curl --location --request GET 'https://api-stg.directa24.com/v3/exchange_rates/crypto?currency=BRL&crypto=USDT' \
--header 'Authorization: Bearer your_read_only_key_here'


```

{% endtab %}

{% tab title="JAVA" %}

```java
import java.io.*;
import okhttp3.*;

public class main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    Request request = new Request.Builder()
      .url("https://api-stg.directa24.com/v3/exchange_rates/crypto?currency=BRL&amount=1000&crypto=USDT")
      .method("GET", null)
      .addHeader("Authorization", "Bearer your_read_only_key_here")
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
  }
}


```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using RestSharp;

namespace HelloWorldApplication {
    class HelloWorld {
        static void Main(string[] args) {
            var client = new RestClient("https://api-stg.directa24.com/v3/exchange_rates/crypto?currency=BRL&amount=1000&crypto=USDT");
            client.Timeout = -1;
            var request = new RestRequest(Method.GET);
            request.AddHeader("Authorization", "Bearer your_read_only_key_here");
            IRestResponse response = client.Execute(request);
            Console.WriteLine(response.Content);
        }
    }
}


```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api-stg.directa24.com/v3/exchange_rates/crypto?currency=BRL&amount=1000&crypto=USDT",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer your_read_only_key_here"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;



```

{% endtab %}
{% endtabs %}

## Example Response

```java
{
  "fx_rate": 5.8829,
  "converted_amount": 58.829,
  "fee": 0.64
}
```

###

### Response fields

| Field name         | Format | Description                                                    |
| ------------------ | ------ | -------------------------------------------------------------- |
| `fx_rate`          | Number | Exchange rate of the cryptocurrency against the base currency  |
| `converted_amount` | Number | Amount in the cryptocurrency specified. Default: 1             |
| `fee`              | Number | Fee for converting the specified amount to the cryptocurrency. |