# 為替レート

> 法定通貨と暗号資産間の現在の為替レートを取得するパブリックエンドポイント。

為替レートエンドポイントは、サポートされているすべての通貨 — 法定通貨（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]` は `FROM` 1 単位を `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:** レートは頻繁に更新されますが、取引のために保証されるものではありません。スリッページを最小化するため、決済または出金を作成する直前に必ずレートを再取得してください。

## Crypto pair prices

`GET /v1/prices`

Public price feed for cryptocurrency pairs. No authentication required.

Returns all supported pairs — direct coin→USDT pairs and synthetic cross-pairs via USDT (e.g. TRX→TON). Price already includes the platform markup.

### Response example

```json
[
  {"from": "BTC",  "to": "USDT", "price": "105234.5"},
  {"from": "ETH",  "to": "USDT", "price": "3812.08"},
  {"from": "USDT", "to": "USDC", "price": "1.0012"},
  {"from": "TRX",  "to": "TON",  "price": "0.000834"}
]
```

### Response fields

| Field | Type | Description |
|-------|------|-------------|
| `from` | string | Source currency |
| `to` | string | Target currency |
| `price` | string | Rate: how many `to` units per 1 `from` unit |

### cURL example

```bash
curl https://api.2328.io/api/v1/prices
```