# 汇率数据

外汇日线行情，默认品种为USDCNH(美元兑离岸人民币)，提供买价与卖价各自的开高低收。离岸人民币汇率是观察人民币国际预期与跨境资金面的重要指标，常用于跨境组合估值、汇率风险对冲及外资流向研判。每个交易日更新；汇率为美元兑人民币报价，可指定其他货币对。

`GET /v2/fx/daily`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 外汇代码，默认 USDCNH.FXCM |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |
| `trade_date` | string | 否 | 交易日期，YYYYMMDD（查单日） |

## 关键返回字段

| 字段 | 说明 |
| --- | --- |
| `symbol` | 外汇对代码 |
| `bid_open / bid_close / bid_high / bid_low` | 买入价 开/收/高/低 |
| `ask_open / ask_close / ask_high / ask_low` | 卖出价 开/收/高/低 |

## 接口示例

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/fx/daily?symbol=USDCNH.FXCM"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.fx_daily(symbol="USDCNH.FXCM")
print(df.head())
```

## 数据样例

返回 pandas.DataFrame

| symbol | trade_date | bid_open | bid_close | bid_high | bid_low | ask_open | ask_close | ask_high | ask_low | … +1 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| USDCNH.FXCM | 20260625 | 6.8009 | 6.8023 | 6.8029 | 6.7981 | 6.8023 | 6.803 | 6.8036 | 6.8008 | … |
| USDCNH.FXCM | 20260624 | 6.8127 | 6.8009 | 6.8161 | 6.7966 | 6.8139 | 6.8023 | 6.8183 | 6.7972 | … |
| USDCNH.FXCM | 20260623 | 6.7944 | 6.8127 | 6.8192 | 6.7908 | 6.7955 | 6.8139 | 6.8198 | 6.7913 | … |
