关于数据范围、计费、限流与接入方式的高频问题。每个问题的第一句就是结论，细节在后面。
| 在售品种 | 70 个（上期所 · 上金所 · 外盘 · 广期所 · 指数 等） |
| 行情刷新 | 每分钟自动刷新全部在售品种，写入服务端缓存后对外提供 |
| 历史数据 | 自 2026-05-27 起，小时级 OHLCV，单次最长 92 天 |
| 免费额度 | 注册赠送 5,000 次全品种调用 |
| 接口形态 | REST（GET / POST / 请求头）+ MCP（AI 助手直连） |
| 近 7 天平均响应 | 7 ms（成功请求均值，实时数据见服务状态页） |
GoldAPI 数据服务平台 是一个贵金属行情数据接口服务平台，提供黄金、白银、铂金、钯金的实时与历史行情 API。开发者注册后获得专属 AppKey，用一条 HTTP 请求即可取回上金所 T+D、现货、机构报价、伦敦金（XAUUSD）与纽约期货主力等品种的报价，平台负责上游取数、缓存、鉴权、限流与用量计量。
当前在售 70 个品种，覆盖 上期所、上金所、外盘、广期所、指数、机构报价 等市场。完整清单（含 goldId、名称、市场、类别、是否增值品种）可通过接口 GET /api/v1/gold/varieties 获取，也可直接查看品种明细页。
平台每分钟自动刷新一次全部在售品种行情并写入服务端缓存，正常调用直接命中缓存，响应通常在数十毫秒量级；最近 7 天成功请求的平均响应时间与每日可用率在服务状态页实时公示。
邮箱验证即可自助注册，无需人工审核，注册成功后系统自动签发默认 AppKey，并赠送 5,000 次全品种调用额度。一个账户可创建多把 AppKey，每把可单独限定可用品种范围，随时停用或重置。
按调用次数计费，有三种互不冲突的通道：① 会员（全品种，消耗账户配额）；② 单品订阅（已开通且在有效期内，不限量且不占会员配额）；③ 赠送额度（注册赠送，全品种可用）。计费优先级为「付费优先」：白名单 → 单品 → 会员 → 赠送额度。额度耗尽后接口返回明确的错误码（如 FREE_QUOTA_EXHAUSTED），不会静默失败，也不会产生意外扣费。
四个数据接口：实时行情 GET /api/v1/gold/realtime（支持逗号分隔一次查询最多 50 个品种，只计 1 次调用）、历史行情 GET /api/v1/gold/history（小时级 OHLCV）、品种清单 GET /api/v1/gold/varieties（免费）、以及公开的日级 K 线端点 kline_data.php（免费，按 IP 限速）。全部接口同时支持 GET 查询串、POST 表单与请求头传密钥。
历史数据自 2026 年 5 月 27 日起提供，粒度为小时级 OHLCV，按时间升序返回；单次请求时间范围最长 92 天，超出范围或早于起始日期会返回明确的参数错误提示。需要更长区间时可分段多次请求。
可以。平台提供标准 MCP 服务，端点为 https://www.gold-api.cn/mcp（Streamable HTTP，JSON-RPC 2.0），已收录于官方 MCP Registry。可用工具包括 list_varieties、get_realtime、get_history、get_kline，在支持 MCP 的客户端里填上 URL 与 Authorization: Bearer 你的AppKey 即可在对话中直接查询行情，鉴权与计费同 REST 接口。
有。账户级与密钥级 QPS 双层限流，单品订阅另有独立 QPS 配置。超限返回限流错误码，并在响应头附带剩余调用量与重置时间，建议客户端按 X-RateLimit-* 头做退避重试。
数据采集自公开渠道与合作方来源，经统一清洗、换算与缓存后对外提供，接口字段结构长期稳定。行情可能出现延迟、缺失或误差，平台不作准确性担保，也不构成投资建议；服务可靠性与数据新鲜度可在服务状态页核对。
平台收取的是技术服务费（接口接入、密钥分发、运维与带宽成本），收费不代表数据所有权转移。默认服务范围是技术交流、学习研究与功能验证；商业用途需先与我们沟通确认，详见站内免责声明。
提供会员全品种与单品按品种订阅两种方式，具体价格见价格套餐页；也可以选择本地化部署，把行情服务部署到你自己的服务器，另有门店大屏展示方案，适合金店、回收商与门店报价场景。