外汇数据查询：热门外汇列表接入点详解（编码与中文名对照）
# 外汇数据查询：热门外汇列表接入点详解（编码与中文名对照）
> 接入点：热门外汇列表（1683-1） · 免费 · POST/GET · 返回 JSON · 适用：所有使用者（编码来源） · 阅读时间：6 分钟
## TL;DR
- 1683-1 返回一份**固定的可查货币对清单**（`forexList`），含 `code` 与 `forexName` 对照。
- 它是日线（1683-2）、分钟 K 线（1683-3）`code` 参数的**权威来源**——传参必须用这里出现的编码。
- 该接入点无业务参数，调用最简单。
## Why：为什么这个「列表」很重要
很多新手直接拍脑袋写 `code=EURUSD` 去查日线，结果报错或空数据。原因往往是编码格式不对（例如该接口用 `EURCNY`/`EURUSD` 这种六位直连写法，而非带分隔符的 `EUR/USD`）。先调一次 1683-1，把官方返回的 `code` 存下来当字典，后面所有查询都从这份字典取，能彻底规避「编码写错」。
## What：接口速览
| 项 | 说明 |
|----|------|
| 接口地址 | `https://route.showapi.com/1683-1?appKey={your_appKey}` |
| 业务参数 | 无 |
| 返回核心 | `showapi_res_body.forexList: [{code, forexName}]` |
| 数据性质 | 延迟数据，仅供学习分析，不得用于对外展示 |
## How：把列表变成可复用字典（Python）
```python
import requests, json
def get_hotlist(appkey: str) -> dict:
r = requests.post("https://route.showapi.com/1683-1",
data={"appKey": appkey}, timeout=10)
data = r.json()
if data.get("showapi_res_code") != 0:
raise RuntimeError(data.get("showapi_res_error"))
return {i["code"]: i["forexName"]
for i in data["showapi_res_body"]["forexList"]}
code_map = get_hotlist("YOUR_APPKEY")
print("可查编码数:", len(code_map))
# 之后查日线直接用 code_map 里的 key
print(code_map.get("USDCNY")) # 美元兑人民币
```
## 返回示例（节选真实编码）
```json
"forexList": [
{ "code": "DINIW", "forexName": "美元指数" },
{ "code": "AUDCNY", "forexName": "澳大利亚元兑人民币" },
{ "code": "AUDUSD", "forexName": "澳大利亚元兑美元" },
{ "code": "USDCNY", "forexName": "美元兑人民币" },
{ "code": "USDJPY", "forexName": "美元兑日元" },
{ "code": "USDKRW", "forexName": "美元兑韩元" },
{ "code": "USDMOP", "forexName": "美元兑澳门元" }
]
```
> 完整清单约 35 个，以接口实际返回为准（含 DINIW 美元指数及多个 USD 直盘/交叉盘）。
## 进阶 / 边界
- **编码是六位直连写法**：如 `USDCNY`、`EURUSD`，不是 `USD/CNY`。拼接或人工猜测容易错，务必以列表为准。
- **这是「可查清单」不是行情**：它告诉你有哪些编码可查，不含实时价格。
- **海外列表（1683-4）编码不同**：1683-4 用的是 `AUDCAD.FXCM` 这种带交易商后缀的编码，与 1683-1 的清单互不可换。
## FAQ
**Q1：为什么我写的 code 查不到数据？**
A：最可能是编码格式不符。请先用 1683-1 拿到官方 `code` 列表，从里面取。
**Q2：清单会经常变吗？**
A：作为可查范围，结构稳定；但若新增/下线货币对，以接口实时返回为准，建议运行时动态获取而非硬编码。
**Q3：DINIW 是什么？**
A：美元指数（Dollar Index），是衡量美元对一篮子货币强弱的指标，不是单一货币对。
**Q4：这个列表能当汇率展示用吗？**
A：不能，它不含价格且为延迟数据，仅用于学习分析。
## 下一步阅读
- [外汇数据查询：code 货币对编码规则与常见对照](https://www.showapi.com/guides/forex-code-lookup-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)
