期貨 API 資料服務

我們定價的每一種合約，附上 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。