# Wechselkurse

> Öffentlicher Endpoint zum Abrufen aktueller Wechselkurse zwischen Fiat- und Kryptowährungen.

Der Endpoint für Wechselkurse liefert eine Matrix der aktuellen Wechselkurse zwischen allen unterstützten Währungen — sowohl Fiat (USD, EUR, RUB usw.) als auch Krypto (BTC, ETH, USDT usw.).

> **INFO:** Dies ist ein **öffentlicher Endpoint**. Er erfordert keine Authentifizierung und keine `project`- oder `sign`-Header.

## Wechselkurse abrufen

`GET /v1/exchange-rates`

### Antwortbeispiel

```json
{
  "state": 0,
  "result": {
    "USD": {
      "USD": "1.00000000",
      "EUR": "0.86090000",
      "RUB": "78.32190000",
      "BTC": "0.00001055",
      "USDT": "1.00000000"
    },
    "BTC": {
      "USD": "94786.69000000",
      "EUR": "81589.12000000",
      "ETH": "29.02345678",
      "USDT": "94786.69000000"
    }
  }
}
```

### So lesen Sie das Ergebnis

Die Antwort ist ein verschachteltes Objekt: `result[FROM][TO]` ist der Wechselkurs für 1 Einheit von `FROM` zu `TO`.

- `result["USD"]["RUB"] = 78.32` bedeutet 1 USD = 78,32 RUB
- `result["BTC"]["USD"] = 94786.69` bedeutet 1 BTC = 94.786,69 USD

## PHP-Beispiel

```php
<?php
$ch = curl_init('https://api.2328.io/api/v1/exchange-rates');
curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true ]);

$response = json_decode(curl_exec($ch), true);

if ($response['state'] === 0) {
    $rates = $response['result'];
    $rubAmount = bcmul(100, $rates['USD']['RUB'], 2);
    echo "100 USD = {$rubAmount} RUB\n";
}
```

## cURL-Beispiel

```bash
curl https://api.2328.io/api/v1/exchange-rates
```

> **WARNING:** Die Kurse werden häufig aktualisiert, sind jedoch nicht für den Handel garantiert. Rufen Sie die Kurse stets unmittelbar vor dem Erstellen einer Zahlung oder Auszahlung erneut ab, um Slippage zu minimieren.