期货数据接口总览

我们提供价格的每一种合约，附带其 id、名称、类别、交易所、币种和单位。

期货 id：交易所的根代码，例如 CL、GC、ES 或 6E。不区分大小写。序列为连续近月合约，未做调整：每个换月日都有跳空。

根代码，如 CL。

合约的官方名称。

该商品的稳定键，在现货、期货、预测和实物价格中相同，例如 gold 或 crude-oil。可用它关联这些数据。股指、利率和货币期货省略此项。

原油基准：wti、brent、urals 或 dubai。仅原油返回；没有此项的原油行表示整体原油。

合约交易的交易所。

交易所的 ISO 10383 市场标识代码，例如 XNYM。

价格的币种。

价格的计量单位，如 usd_per_barrel 或 index_point。

单位的规范小写名称，在所有使用该单位的接口中保持一致，例如 barrel、troy_ounce、mmbtu 或 tonne。unit 保留数据源的原始写法。

仅在价格以辅币单位报价时返回。将 price 乘以该值即可得到以 currency 计价的价格：0.01 表示 price 以美分计，因此 unit 为 cent_per_bushel 时，price 为 450 即每蒲式耳 4.50 USD。

以逗号分隔的 id，去重后最多 50 个。每个 id 的规则与单个价格路由相同。每个返回价格的 id 计一次调用。

每个返回了价格的 id 对应一条记录，包含单个价格的各个字段。

未返回价格的 id，每个都带有代码 not_found。这些不收费。

期货 id：交易所的根代码，例如 CL、GC、ES 或 6E。不区分大小写。序列为连续近月合约，未做调整：每个换月日都有跳空。

1d（每个交易日一根 K 线，以其所属日期标注）或 1m（一分钟 K 线，保留 12 个月）。其他取值返回 400 invalid_interval。

起始 K 线。1d：日期（YYYY-MM-DD），含该日；省略则表示最早的一根 K 线。1m：UTC 时间（YYYY-MM-DDTHH:MM:SSZ，或日期，表示 UTC 00:00），含该时刻；省略则表示 end 之前一天。

结束 K 线。1d：日期，含该日；省略则表示最近一个已完成的交易日。1m：UTC 时间，不含该时刻；省略则表示当前时间，或 start 之后五天。1m 的 start 与 end 之间最多相隔 5 天（400 range_too_large）。

上一页的 next_cursor，参数须保持一致。

根代码，如 CL。

该商品的稳定键，在现货、期货、预测和实物价格中相同，例如 gold 或 crude-oil。可用它关联这些数据。股指、利率和货币期货省略此项。

原油基准：wti、brent、urals 或 dubai。仅原油返回；没有此项的原油行表示整体原油。

价格的币种。

仅在价格以辅币单位报价时返回。将 price 乘以该值即可得到以 currency 计价的价格：0.01 表示 price 以美分计，因此 unit 为 cent_per_bushel 时，price 为 450 即每蒲式耳 4.50 USD。

仅在范围起点被向后移动时才会返回。

不再返回，因为所有账户的价格都是实时的。

K 线数据，按时间从旧到新排列。每根包含 timestamp、open、high、low 和 close，不含成交量。

回传该值即可读取下一页。最后一页为 null。