# विनिमय दर

> Fiat और क्रिप्टोकरेंसी के बीच वर्तमान विनिमय दर प्राप्त करने के लिए public endpoint।

Exchange rates endpoint सभी समर्थित currency — fiat (USD, EUR, RUB, इत्यादि) और crypto (BTC, ETH, USDT, इत्यादि) — के बीच वर्तमान विनिमय दरों का एक matrix लौटाता है।

> **INFO:** यह एक **public endpoint** है। इसके लिए authentication की आवश्यकता नहीं होती और न ही `project` या `sign` headers की आवश्यकता होती है।

## विनिमय दर प्राप्त करें

`GET /v1/exchange-rates`

### Response example

```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"
    }
  }
}
```

### Result को कैसे पढ़ें

Response एक nested object है: `result[FROM][TO]` `FROM` की 1 unit के `TO` में विनिमय दर है।

- `result["USD"]["RUB"] = 78.32` का अर्थ है 1 USD = 78.32 RUB
- `result["BTC"]["USD"] = 94786.69` का अर्थ है 1 BTC = $94,786.69

## PHP example

```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 example

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

> **WARNING:** दरें बार-बार update होती हैं लेकिन trading के लिए guaranteed नहीं हैं। Slippage कम करने के लिए payment या payout बनाने से ठीक पहले हमेशा rates को फिर से fetch करें।