ETH价格快照查询:product_id填什么、请求失败返回什么

查ETH行情快照时,Coinbase交易所ticker接口路径里的product_id是一个必填的路径参数,需要填写具体交易对标识,而非资产名称“ETH”。按照Coinbase Exchange REST API产品行情接口文档,请求地址模板为https://api.exchange.coinbase.com/products/{product_id}/ticker,调用方须把{product_id}替换为目标交易对。该接口页未列举全部可用交易对,因此不能从这一页推断ETH相关交易对的完整清单;具体填写值应以产品列表接口或其他官方产品资料为准。本文只讨论参数含义与响应结构,不构成投资、交易或法律建议。

路径参数、必填字段、错误消息
本文涉及的概念与核对环节。

product_id在请求路径中的位置

接口路径为/products/{product_id}/ticker,其中{product_id}是字符串类型且标注为required的路径参数。这意味着请求地址中既不能省略这一段,也不能保留花括号占位符。文档给出的示例代码使用带{product_id}的URL,属于模板写法;若原样发出请求,占位符不会自动替换,可能不会命中目标产品。查询ETH行情快照时,应把占位符换成调用方所需观察市场的交易对标识;这一页没有提供ETH交易对的具体示例,实际取值需查产品列表接口。

请求成功返回的快照字段

按文档的200响应示例,成功返回JSON对象,字段包括trade_id、price、size、time、bid、ask、volume,示例中还出现rfq_volume和conversions_volume,这两个字段未标注必填。类型方面,ask、bid、volume、price、size为字符串,trade_id为32位整数,time为ISO 8601时间戳。示例中price为“6268.48”,bid为“6265.15”,ask为“6267.71”。这些字段描述的是一次快照数据,并非实时推送。

请求失败返回的结构

文档列出500响应,结构为{ "message": "<string>" },即一个含message字符串字段的JSON对象。该结构只说明错误响应的外形,不保证具体错误文案。请求失败时,应先检查HTTP状态码,再读取响应体中的message。若路径参数缺失或占位符未替换,请求可能不会命中目标产品,这类路径问题应与服务端500错误区分看待。文档本页未展开其他状态码的语义,不宜补猜。

快照接口与实时更新的口径差异

文档明确建议,实时更新应通过WebSocket流并监听match消息获取,而不是轮询ticker接口。这一建议适用于需要持续跟踪行情变化的场景;若只是查询一次ETH行情快照,ticker接口仍是对应工具。两者口径不同:REST返回单次快照,WebSocket面向持续消息流,调用方应按用途选择,而不是把快照接口当作实时行情源。

综合文档可确认:product_id是必填路径参数;成功响应包含价格、买卖价、成交量等快照字段;失败响应为带message的JSON结构。查询ETH行情快照时,应把模板中的{product_id}替换为具体交易对标识,并确保URL中不残留花括号;若请求失败,先核对路径参数是否已正确替换,再查看状态码与message。文档本页未列举全部交易对,也未给出实时价格、费用或合规资格信息,这些内容不应从本页推断。

原始资料

docs.cdp.coinbase.com

上一篇 XRP储备能付手续费吗?可以,但转不出去