@pipeworx/cn-futures

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/cn-futures’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

Daily settlement prices, volume and open interest for China commodity futures (rebar, cotton, gold, silver, crude, lithium carbonate and more) from SHFE, INE, ZCE and GFEX, plus SHFE warehouse-receipt stocks.

Tools

• cn_futures_daily(product, exchange?, date?) — every contract of one product for one trading day: open, high, low, close, settlement, prior settlement, volume (lots), open interest, turnover, with a main contract (highest open interest). A listed-but-dormant product such as ZCE wheat returns status: "no_listed_activity" and an explanation instead of an empty list.
• cn_futures_products(exchange, date?) — every product in one exchange’s daily report, ranked by open interest, so a caller can find product codes.
• cn_futures_warehouse_stocks(product?, date?) — SHFE warehouse-receipt (warrant) stocks per product with day-over-day change and per-warehouse breakdown; gold and silver in kilograms, the rest in tonnes.

Prices are CNY. date is YYYY-MM-DD or YYYYMMDD and defaults to the latest published trading day. A weekend or exchange holiday returns an explicit error naming the date, never an empty result.

Auth

Keyless.

Data sources

• Shanghai Futures Exchange (SHFE), daily trading data and daily warehouse-receipt report. Also carries the INE products (crude oil, low-sulphur fuel oil, No. 20 rubber, international copper).
• Zhengzhou Commodity Exchange (ZCE), daily trading data.
• Guangzhou Futures Exchange (GFEX), daily trading data.

Each call reads the exchange’s published end-of-day report live; nothing is stored. Reports appear after the close (about 15:30 China time); before 16:00 China time the default date steps back to the previous trading day.

Notes:

• Dalian Commodity Exchange (DCE) is not covered: its site answers automated requests with a browser challenge, and this pack does not work around bot checks. DCE product codes return an explicit error.
• The exchanges do not designate a main contract. main_contract is derived here as the contract with the highest open interest.
• Warehouse figures are the quantity made into registered warrants, not total physical inventory.
• Contract-month codes are normalised to four digits (ZCE publishes three: CF701 is returned as CF2701).
• Spot prices (for example East China HRB400 rebar or wheat purchase prices) are not exchange data and are not covered.

Tools

• cn_futures_daily — Daily settlement report for one China commodity futures product on one trading day: every contract’s open, high, low, close, settlement, prior settlement, volume (lots), open interest and turnover, pl
• cn_futures_products — List every product in one China futures exchange’s daily report (SHFE, INE, ZCE or GFEX) for a trading day, ranked by open interest: contract count, total volume, total open interest, main contract an
• cn_futures_warehouse_stocks — Shanghai Futures Exchange daily warehouse-receipt (warrant) stocks: gold and silver in kilograms, base metals, rebar, hot-rolled coil and other products in tonnes, with the day-over-day change and the