# 汇率

> 用于获取法币与加密货币之间当前汇率的公共端点。

汇率端点返回所有支持币种之间的当前汇率矩阵 — 包括法币（USD、EUR、RUB 等）和加密货币（BTC、ETH、USDT 等）。

> **INFO:** 这是一个**公共端点**。无需身份验证，也不需要 `project` 或 `sign` 请求头。

## 获取汇率

`GET /v1/exchange-rates`

### 响应示例

```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[FROM][TO]` 表示 1 单位 `FROM` 兑换为 `TO` 的汇率。

- `result["USD"]["RUB"] = 78.32` 表示 1 USD = 78.32 RUB
- `result["BTC"]["USD"] = 94786.69` 表示 1 BTC = $94,786.69

## PHP 示例

```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 示例

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

> **WARNING:** 汇率会频繁更新，但不保证可用于交易。请始终在创建支付或提现之前重新获取汇率，以最大限度减少滑点。