# 外汇数据查询：code 货币对编码规则与常见对照
> 接口级 · 免费 · 返回 JSON · 适用：所有使用者（传参前必读） · 阅读时间：6 分钟
## TL;DR
- 编码是六位「基础货币+报价货币」直连写法（如 `USDCNY`、`EURUSD`），**不是** `USD/CNY` 带斜杠形式。
- 编码的权威来源是热门外汇列表（1683-1）的 `forexList`；海外列表（1683-4）用带 `.FXCM` 后缀的不同体系。
- 日线/分钟 K 线的 `code` 必须用 1683-1 返回的编码，否则查不到。
## Why：编码写错是最常见的「查无数据」原因
接口对 `code` 格式敏感。新手常犯两个错：一是写成 `USD/CNY`（带分隔符），二是凭记忆拼 `EURUSD` 却拼错大小写或顺序。统一从 1683-1 动态取码，是避免这类问题的最省心办法。
## What：编码体系对照
| 体系 | 示例 | 来源接入点 | 用途 |
|------|------|-----------|------|
| 六位直连（基础+报价） | `USDCNY`(美元兑人民币)、`USDJPY`(美元兑日元)、`AUDCNY` | 1683-1 热门列表 | 日线(1683-2)、分钟K(1683-3) 的 `code` |
| 带交易商后缀 | `AUDCAD.FXCM` | 1683-4 海外列表 | 仅标识 FXCM 品种，不可用于 1683-2/3 |
> 编码读法：`USDCNY` = 1 美元可兑换多少人民币（基础货币 USD 在前，报价货币 CNY 在后）。
## How：运行时取码 + 校验（Python）
```python
import requests
def valid_codes(appkey: str) -> set:
r = requests.post("https://route.showapi.com/1683-1",
data={"appKey": appkey}, timeout=10)
return {i["code"] for i in r.json()["showapi_res_body"]["forexList"]}
codes = valid_codes("YOUR_APPKEY")
user_input = "USDCNY"
if user_input in codes:
print("编码有效，可查询")
else:
print("编码无效，请从热门列表中选取：", sorted(codes)[:10])
```
## 常见编码速查（节选自 1683-1 真实返回）
| code | 中文名 |
|------|--------|
| DINIW | 美元指数 |
| AUDCNY | 澳大利亚元兑人民币 |
| AUDUSD | 澳大利亚元兑美元 |
| CADCNY | 加拿大元兑人民币 |
| CHFCNY | 瑞士法郎兑人民币 |
| CNYJPY | 人民币兑日元 |
| CNYKRW | 人民币兑韩元 |
| EURCNY | 欧元兑人民币 |
| EURUSD | 欧元兑美元 |
| GBPCNY | 英镑兑人民币 |
| USDCNY | 美元兑人民币 |
| USDJPY | 美元兑日元 |
| USDKRW | 美元兑韩元 |
> 完整清单约 35 个，以 1683-1 实时返回为准。
## 进阶 / 边界
- **大小写敏感**：示例均为大写，传参请保持大写。
- **不要手拼海外编码**：1683-4 的 `.FXCM` 编码体系与 1683-1 不同，切勿混用。
- **动态取码优于硬编码**：货币对范围可能调整，运行时拉取最稳。
## FAQ
**Q1：USD/CNY 为什么查不到？**
A：接口用六位无分隔符写法 `USDCNY`，斜杠形式不被接受。
**Q2：EURUSD 和 USDEUR 一样吗？**
A：不一样，顺序决定「基础/报价」关系，必须按接口提供的编码来。
**Q3：海外列表的编码能查日线吗？**
A：不能，1683-4 的 `.FXCM` 编码与 1683-2/3 不通用。
**Q4：编码会新增吗？**
A：以接口实时返回为准，建议动态获取。
## 下一步阅读
- [外汇数据查询：热门外汇列表接入点详解](https://www.showapi.com/guides/forex-hotlist-guide-1683)
- [外汇数据查询：日线历史查询接入点实战](https://www.showapi.com/guides/forex-daily-history-1683)
- [外汇数据查询：海外外汇列表接入点详解](https://www.showapi.com/guides/forex-overseas-list-1683)
- **本系列共 13 篇**：查看[外汇数据查询指南总目录](https://www.showapi.com/guides/forex-guides-1683)
