国内贵金属期货合约

接口简介

本接口用于查询国内交易所上市的贵金属期货合约基础信息。通过传入品种标识，返回对应的合约代码（symbol）及中文名称（name），帮助开发者构建标准化的交易标的映射表。

适用场景

• 金融终端开发：自动同步上期所黄金、白银等主力及非主力合约列表。
• 量化策略系统：动态获取可交易合约代码，避免硬编码导致的合约过期错误。
• 行情数据展示：为用户提供清晰的合约选择下拉菜单，显示标准合约名称。

请求与返回说明

• 请求方式：POST
• 关键参数：symbol（必填），指定贵金属品种类型。
• 返回结构：
• code/msg：接口状态码及描述。
• data.list：合约数组，包含 symbol（如 AU2412）和 name（如 黄金2412）。

接入建议

1. 缓存机制：合约列表变更频率较低（通常在换月期），建议本地缓存 24 小时以减少调用成本。
2. 异常处理：请校验返回的 code 是否为 200，并妥善处理空列表情况。
3. 数据映射：利用返回的 symbol 作为唯一键，关联实时行情或历史数据接口。