外汇数据查询：海外外汇列表接入点详解（FXCM 数据与七大分类）
约 7 分钟 进阶外汇数据查询海外外汇列表FXCM品种清单
# 外汇数据查询：海外外汇列表接入点详解（FXCM 数据与七大分类）
> 接入点：海外外汇列表（1683-4） · 免费 · POST/GET · 返回 JSON · 适用：海外品种研究、量化教学 · 阅读时间：7 分钟
## TL;DR
- 1683-4 返回**海外可交易品种清单**（页面标题为「海外外汇列表」，产品导航误标为「汇率转换」）。
- 数据**暂只有 FXCM 一家交易商**，含外汇、指数、大宗商品、金属、国债、加密、外汇篮子共七大类。
- 无业务请求参数；返回 `list` 每项含 `classify`、`code`(带 `.FXCM` 后缀)、`exchange` 等元数据。
## Why：这个接入点和「热门外汇列表」有什么不同
1683-1 给的是国内视角的热门货币对（如 `USDCNY`）；1683-4 给的是**海外经纪商 FXCM 的上架品种**，编码形如 `AUDCAD.FXCM`，还带分类、点值、交易时间等元数据。做海外品种研究或量化教学时，这份清单能告诉你「FXCM 上有哪些可研究的对象」。
## What：接口速览
| 项 | 说明 |
|----|------|
| 接口地址 | `https://route.showapi.com/1683-4?appKey={your_appKey}` |
| 业务参数 | 无（仅 Header `content-type`，可选） |
| 返回核心 | `ret_code`(Number)、`list: [{trading_time, classify, forex_name, max_unit, pip, target_diff, closed_time, code, min_stop_distance, min_unit, exchange, pip_cost}]` |
| 数据范围 | 暂仅 FXCM；分类含 FX/INDEX/COMMODITY/METAL/BUND/CRYPTO/FX_BASKET |
| 数据性质 | 仅供学习分析，不得用于对外展示 |
## How：拉取清单并按分类过滤（Python）
```python
import requests
def overseas_list(appkey: str) -> list:
r = requests.post("https://route.showapi.com/1683-4",
data={"appKey": appkey}, timeout=10)
data = r.json()
if data.get("showapi_res_code") != 0:
raise RuntimeError(data.get("showapi_res_error"))
body = data["showapi_res_body"]
if str(body.get("ret_code")) != "0":
raise RuntimeError(f"ret_code={body.get('ret_code')}")
return body["list"]
items = overseas_list("YOUR_APPKEY")
fx = [i for i in items if i.get("classify") == "FX"]
print("FX 类数量:", len(fx))
for i in fx[:5]:
print(i["code"], i["forex_name"], "交易商:", i["exchange"])
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/1683-4?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded"
```
## 返回示例（节选）
```json
{
"showapi_res_body": {
"ret_code": 0, "showapi_fee_code": 0,
"list": [
{ "trading_time": " Sun 17.00 - Fri 16.55", "classify": "FX",
"forex_name": "澳元加元", "max_unit": "", "pip": "0.000010",
"target_diff": "", "closed_time": "", "code": "AUDCAD.FXCM",
"min_stop_distance": "", "min_unit": "1.0000",
"exchange": "FXCM", "pip_cost": "" }
]
}
}
```
## 进阶 / 边界
- **编码带交易商后缀**：`AUDCAD.FXCM` 与 1683-1 的 `AUDCAD` 不是一回事，两者互不可换。
- **分类字段值要记牢**：`classify` 取 FX / INDEX / COMMODITY / METAL / BUND / CRYPTO / FX_BASKET 七种之一，用于分组展示。
- **很多字段可能为空**：`max_unit`、`target_diff`、`closed_time`、`min_stop_distance`、`pip_cost` 在示例里是空串，使用前先判空。
## FAQ
**Q1：为什么叫「海外外汇列表」却导航写「汇率转换」？**
A：产品页导航标签有误，该接入点真实页面标题为「海外外汇列表」，返回的是 FXCM 品种清单，并非换算接口。
**Q2：只有 FXCM 一家吗？**
A：文档明确「暂只有 FXCM 的数据」，后续是否扩展开以官方为准。
**Q3：code 后缀 .FXCM 能去掉吗？**
A：不能，这是该接入点的编码规则，去掉可能查不到。
**Q4：这份清单有价格吗？**
A：没有，它只描述「有哪些可研究品种及元数据」，不含行情，且仅供学习分析。
## 下一步阅读
- [外汇数据查询：热门外汇列表接入点详解](https://www.showapi.com/guides/forex-hotlist-guide-1683)
- [外汇数据查询：code 货币对编码规则与常见对照](https://www.showapi.com/guides/forex-code-lookup-1683)
- [外汇数据查询：返回字段与数据结构全解](https://www.showapi.com/guides/forex-response-fields-1683)
- **本系列共 13 篇**：查看[外汇数据查询指南总目录](https://www.showapi.com/guides/forex-guides-1683)
