# ⚡ Commodity Futures Tracker — Energy, Metals, Grains (`nexgendata/commodity-futures-tracker`) Actor Track global commodity futures: WTI crude, Brent, gold, silver, copper, corn, wheat, soybeans, coffee, sugar, plus index and crypto futures. Bloomberg commodity data alternative for hedge funds, traders, miners. Pay-per-result. - **URL**: https://apify.com/nexgendata/commodity-futures-tracker.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 futures records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ⚡ Commodity Futures Tracker — Energy, Metals, Grains, Livestock & Softs **The Bloomberg commodities terminal, without the $24,000-a-year terminal.** Live front-month futures prices for the entire global commodity complex — WTI and Brent crude, Henry Hub natural gas, gold, silver, copper, platinum, palladium, corn, wheat, soybeans, oats, soybean meal/oil, live cattle, feeder cattle, lean hogs, coffee, sugar, cocoa, cotton, orange juice, lumber — plus E-mini equity-index futures and CME-listed Bitcoin and Ether futures. One actor. One JSON shape. One pay-per-result API call away. Built for **commodity hedge funds, mining and energy companies, agricultural producers, prop trading firms, ETF issuers, and macro analysts** who need clean, machine-readable futures data without paying Refinitiv or Bloomberg for a terminal seat they barely use. --- ### Why this exists Commodity data is locked behind some of the most expensive financial information products on the market: - **Bloomberg Terminal** — $24,000+ per user per year. Industry standard, but you pay for hundreds of features you'll never touch. - **Refinitiv Eikon / Workspace** — $22,000+ per user per year. Similar story. - **Reuters Eikon** — bundled into LSEG Workspace at similar pricing. - **TradingEconomics** — $99+/month per user for API access, throttled and rate-limited. - **Investing.com Pro** — $14.99+/month, but the data is in HTML that has to be scraped behind a paywall and consent banner. - **CME Group DataMine** — historical and intraday futures data, priced per exchange/asset and aimed at vendors, not end users. Meanwhile, every quant researcher, commodity desk analyst, and hedge fund engineer ends up scraping Yahoo Finance or the CME website anyway. **This actor does the scraping properly, at industrial scale, on a pay-per-record basis** — so you stop maintaining brittle CSV downloaders and you stop overpaying Bloomberg for the 0.1% of features you actually use. --- ### Who this is for - **Commodity hedge funds** — daily mark-to-market on a multi-asset book without buying a Bloomberg seat for every junior analyst. - **Mining companies & energy producers** — hedge program monitoring (gold, silver, copper, WTI, Brent, natural gas) against your physical exposure. - **Agricultural traders & cooperatives** — corn, wheat, soybean complex (beans/meal/oil), oats, rice, livestock — front-month prices, weekly/monthly/YTD context. - **Macro & cross-asset desks** — equity-index futures alongside commodities and FX, all in one dataset for cross-asset regime analysis. - **ETF issuers & product structurers** — commodity ETF NAV benchmarking (USO, GLD, SLV, DBA, DBC, PDBC, USCI, BNO). - **Quant researchers** — programmatic, deterministic schema for factor research, backtesting, and signal generation. - **AI / agent builders** — feed the dataset into an MCP server, a RAG store, a Slack digest, or a custom GPT for natural-language commodity Q&A. --- ### What you get — schema Every row in the dataset has the following fields: | Field | Type | Example | Meaning | |---|---|---|---| | `symbol` | string | `GC=F` | Yahoo Finance ticker (`=F` suffix). | | `commodity_name` | string | `Gold` | Human-readable commodity name. | | `category` | string | `Metals` | One of `Energy`, `Metals`, `Grains`, `Livestock`, `Softs`, `Indices`, `Crypto`. | | `contract_month` | string \| null | `Jun 2026` | Front-month contract delivery month (when Yahoo exposes `expireDate`). | | `price` | number | `2384.5` | Last traded / settlement price. | | `currency` | string | `USD` | Quote currency. | | `unit` | string | `per troy ounce` | Unit the price is quoted in (per barrel, per bushel, per pound, etc.). | | `change_pct_1d` | number \| null | `0.42` | % change vs prior session. | | `change_pct_1w` | number \| null | `1.85` | % change vs 7 days ago. | | `change_pct_1m` | number \| null | `-3.20` | % change vs 30 days ago. | | `change_pct_ytd` | number \| null | `12.40` | % change vs first observation of current year. | | `volume` | integer \| null | `218450` | Volume on the latest session. | | `open_interest` | integer \| null | `412300` | Open interest (when Yahoo's quote endpoint returns it). | | `52w_high` | number \| null | `2450.8` | Highest close in the trailing 52 weeks. | | `52w_low` | number \| null | `1810.4` | Lowest close in the trailing 52 weeks. | | `as_of_date` | string | `2026-05-11` | Observation date (ISO‑8601). | | `exchange` | string \| null | `NYM` | Exchange code returned by Yahoo (CME/NYMEX/COMEX/ICE/CBOT). | | `instrument_type` | string | `FUTURE` | Always `FUTURE`. | | `short_name` | string \| null | `Gold Jun 26` | Yahoo's short instrument name. | | `data_source` | string | `Yahoo Finance — v8 chart API (futures)` | Provenance. | --- ### Input ```json { "symbols": ["GC=F", "CL=F", "HG=F", "ZC=F", "ES=F"], "limit": 5 } ```` | Input | Type | Default | Notes | |---|---|---|---| | `symbols` | array of strings | `[]` | Specific Yahoo Finance futures tickers. Pass any `=F` ticker — overrides the categories filter when non-empty. | | `categories` | array of strings | `["Energy", "Metals", "Grains", "Livestock", "Softs"]` | Curated-universe filter when `symbols` is empty. | | `include_indices` | boolean | `false` | Adds `ES=F`, `NQ=F`, `YM=F`, `RTY=F` to the curated pull. | | `include_crypto_futures` | boolean | `false` | Adds `BTC=F`, `ETH=F` to the curated pull. | | `limit` | integer | `0` (no limit) | Max records to emit. Capped at 500. | If `symbols` is non-empty it wins — the other filters are ignored and we fetch exactly what you asked for. Tickers we don't recognise still get fetched (and emitted with `category: "Unknown"`). *** ### Curated commodity universe Out of the box, the actor knows about ~30 of the most-traded global futures contracts: - **Energy (5):** `CL=F` WTI Crude, `BZ=F` Brent, `NG=F` Natural Gas, `HO=F` Heating Oil, `RB=F` RBOB Gasoline - **Metals (5):** `GC=F` Gold, `SI=F` Silver, `HG=F` Copper, `PL=F` Platinum, `PA=F` Palladium - **Grains (7):** `ZC=F` Corn, `ZW=F` Wheat, `ZS=F` Soybeans, `ZO=F` Oats, `ZR=F` Rough Rice, `ZM=F` Soybean Meal, `ZL=F` Soybean Oil - **Livestock (3):** `LE=F` Live Cattle, `GF=F` Feeder Cattle, `HE=F` Lean Hogs - **Softs (6):** `KC=F` Coffee, `SB=F` Sugar #11, `CC=F` Cocoa, `CT=F` Cotton, `OJ=F` Orange Juice, `LBR=F` Lumber - **Index futures (4, opt-in):** `ES=F` E-mini S\&P 500, `NQ=F` E-mini Nasdaq-100, `YM=F` E-mini Dow, `RTY=F` E-mini Russell 2000 - **Crypto futures (2, opt-in):** `BTC=F` CME Bitcoin Futures, `ETH=F` CME Ether Futures You can also pass any other Yahoo Finance `=F` ticker we haven't curated — the actor still resolves price, 52w range, and changes; only the friendly `commodity_name` / `category` / `unit` will fall back to defaults. *** ### How it works under the hood 1. **Primary source — Yahoo Finance v8 chart API** (`query1.finance.yahoo.com/v8/finance/chart/?range=1y&interval=1d`). One call per contract returns the full 1-year daily OHLCV plus a `meta` block with exchange, currency, and pre-computed 52-week highs/lows. 2. **Open-interest enrichment** via Yahoo's `v7/finance/quote` endpoint, batched 25 symbols per request. This is the only place Yahoo exposes `openInterest` and `expireDate` for futures. 3. **Concurrency:** symbols are fetched in parallel, capped at 6 concurrent requests so we never hammer Yahoo. 4. **Fallback — stockanalysis.com** for the handful of contracts where Yahoo occasionally times out (gold, silver, crude, brent, nat gas, copper). Light HTML regex extract — just enough to recover a price. 5. **Schema is deterministic** — every record has the same keys, every numeric field is either a number or `null`. No surprises in your data pipeline. *** ### Output example ```json { "symbol": "GC=F", "commodity_name": "Gold", "category": "Metals", "contract_month": "Jun 2026", "price": 2384.5, "currency": "USD", "unit": "per troy ounce", "change_pct_1d": 0.42, "change_pct_1w": 1.85, "change_pct_1m": -3.20, "change_pct_ytd": 12.40, "volume": 218450, "open_interest": 412300, "52w_high": 2450.8, "52w_low": 1810.4, "as_of_date": "2026-05-11", "exchange": "NYM", "instrument_type": "FUTURE", "short_name": "Gold Jun 26", "data_source": "Yahoo Finance — v8 chart API (futures)" } ``` *** ### Pricing — pay per record, not per terminal seat This actor uses Apify's **Pay-Per-Event** model: - **$0.01** per actor start (covers the run cost itself) - **$0.10** per futures contract record returned, with full price + change panel + 52w range + open interest A daily 30-contract snapshot across Energy + Metals + Grains + Softs costs **$0.01 + 30 × $0.10 = $3.01 per run**, or about **$66/month** if you run it once a day. That's roughly **0.27%** of a Bloomberg seat. You only pay for records that actually return a price — failed lookups are skipped, not billed. *** ### Use cases & integration recipes #### 1. Daily commodity hedge-fund P\&L mark Schedule the actor once at 5:00pm New York time, pull the full Energy/Metals/Grains/Softs panel (~26 contracts), wire `price` into your risk engine alongside your physical positions. ~$2.61/run, ~$57/month. #### 2. Mining company hedge program monitoring Schedule daily on `GC=F`, `SI=F`, `HG=F`, `PL=F`, `PA=F`. Drop the `price` + `change_pct_1d` + `52w_high` / `52w_low` into a Slack digest for the treasury team. ~$0.51/run. #### 3. Ag co-op pre-market briefing Schedule pre-open (6:00am Chicago) on `ZC=F`, `ZW=F`, `ZS=F`, `ZM=F`, `ZL=F`, `LE=F`, `GF=F`, `HE=F`. Feed into a daily PDF that goes to producer members. Pairs with our `nexgendata/etf-holdings-tracker` for DBA / DBC ETF context. #### 4. Cross-asset macro dashboard Pull commodities + index futures + Treasury yields (`nexgendata/treasury-yields-bonds`) into a single dashboard. Read regime shifts off curve inversion + commodity moves together. #### 5. ETF NAV / iNAV benchmarking ETF issuers running USO / UNG / GLD / SLV / DBA / DBC: pull underlying futures, weight by basket, compare vs published NAV for tracking-error analysis. *** ### How we compare | Capability | This actor | Bloomberg Terminal | Refinitiv Eikon | Reuters Eikon | TradingEconomics | Investing.com Pro | |---|---|---|---|---|---|---| | Front-month futures price | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Programmatic JSON API | ✅ | Limited (BLPAPI) | Limited (Datastream) | Limited | ✅ (throttled) | ❌ | | 52-week range + changes | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Open interest | ✅ (best effort) | ✅ | ✅ | ✅ | Limited | ❌ | | Multi-asset (commodities + indices + crypto) | ✅ | ✅ | ✅ | ✅ | Partial | Partial | | Pay-per-record | ✅ | ❌ ($24k/yr seat) | ❌ ($22k/yr seat) | ❌ | ❌ ($99+/mo) | ❌ ($14.99/mo) | | Self-serve / no sales call | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | | Deploy as MCP / agent tool | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | *** ### Related NexGenData actors Pair this actor with our other finance / macro tools for a complete market-data stack: - **[`nexgendata/treasury-yields-bonds`](https://apify.com/nexgendata/treasury-yields-bonds)** — US Treasury yield curve (1M to 30Y), 2s10s spread, curve-inversion flag. The macro complement to commodity moves. - **[`nexgendata/finance-mcp-server`](https://apify.com/nexgendata/finance-mcp-server)** — Model Context Protocol server exposing real-time stock/ETF/futures lookups to Claude, ChatGPT, and any MCP client. - **[`nexgendata/finviz-stock-screener`](https://apify.com/nexgendata/finviz-stock-screener)** — Screen 9,000+ stocks on 100+ technical/fundamental filters. Pair with commodity prices to trade producers vs underlying. - **[`nexgendata/etf-holdings-tracker`](https://apify.com/nexgendata/etf-holdings-tracker)** — Commodity-ETF holdings (USO, GLD, SLV, DBA, DBC) for tracking-error analysis vs underlying futures. - **[`nexgendata/asx-australia-stock-screener`](https://apify.com/nexgendata/asx-australia-stock-screener)** — Australian mining-heavy equity universe (BHP, RIO, FMG, NST). Trade producers when commodity prices move. - **[`nexgendata/jse-southafrica-stock-screener`](https://apify.com/nexgendata/jse-southafrica-stock-screener)** — Johannesburg Stock Exchange screener; commodity-heavy index (gold, platinum, diamonds, coal). *** ### FAQ **Q: How fresh is the data?** A: Yahoo Finance's chart API serves end-of-session / 15-minute-delayed prices for most CME futures. Intraday accuracy is good enough for daily marks, dashboards, and digests; for sub-minute tick data you'll still need CME DataMine or a paid vendor. **Q: Why Yahoo Finance and not the CME API directly?** A: CME's official API requires a paid data licence and is priced for institutional vendors. Yahoo Finance pulls from the same source, ships JSON, and is the de-facto endpoint used by every Python `yfinance` script. We probe stockanalysis.com as a fallback for the handful of contracts Yahoo sometimes drops. **Q: Are the prices in cents or dollars?** A: We pass through Yahoo's raw quote — that means grains (`ZC=F`, `ZW=F`, `ZS=F`, `ZO=F`), soybean oil (`ZL=F`), cotton (`CT=F`), coffee (`KC=F`), sugar (`SB=F`), OJ (`OJ=F`), live cattle (`LE=F`), feeder cattle (`GF=F`), and lean hogs (`HE=F`) are quoted in **cents** per their respective unit; everything else in **dollars**. The `unit` field tells you exactly what scale you're looking at. **Q: Can I pass my own list of `=F` tickers?** A: Yes — fill in `symbols` with any Yahoo Finance futures ticker. Tickers outside our curated universe get emitted with `category: "Unknown"` but full price/change/range data. **Q: Does the actor work for back-month / deferred contracts?** A: Yahoo only exposes the continuous front-month under `=F`. For deferred months you'd need CME DataMine or Refinitiv. This is a limitation of the upstream data source, not the actor. **Q: Can I run this as an MCP server for Claude or ChatGPT?** A: Yes — pair it with `nexgendata/finance-mcp-server`, or wrap a thin MCP server around the Apify dataset endpoint. We have a tutorial — ask in Apify console. *** ### Quick start ```bash curl -X POST "https://api.apify.com/v2/acts/nexgendata~commodity-futures-tracker/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "symbols": ["GC=F", "CL=F", "HG=F", "ZC=F"], "limit": 4 }' ``` ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("nexgendata/commodity-futures-tracker").call(run_input={ "categories": ["Energy", "Metals"], "include_indices": True, "limit": 20, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["symbol"], item["price"], item["change_pct_1d"]) ``` *** ### Support & affiliate Built and maintained by **NexGenData**. We run a fleet of 130+ production-grade data actors on Apify covering finance, real estate, e-commerce, lead generation, and macro. **Try Apify free** (1-month platform credit when you sign up via this link, and you'll be helping fund the next NexGenData actor): 👉 **https://apify.com/nexgendata?fpr=2ayu9b** # Actor input Schema ## `symbols` (type: `array`): Optional list of specific Yahoo Finance futures tickers to fetch (e.g., 'GC=F' gold, 'CL=F' WTI crude, 'HG=F' copper, 'ZC=F' corn, 'ES=F' S\&P 500 futures). Leave empty to pull the full curated universe filtered by the categories below. ## `categories` (type: `array`): Which commodity categories to include when no explicit symbols are supplied. Supported values: 'Energy', 'Metals', 'Grains', 'Livestock', 'Softs', 'Indices', 'Crypto'. ## `include_indices` (type: `boolean`): When true, the curated universe also pulls equity-index futures (ES=F, NQ=F, YM=F, RTY=F). Ignored if you pass explicit 'symbols'. ## `include_crypto_futures` (type: `boolean`): When true, the curated universe also pulls CME-listed crypto futures (BTC=F, ETH=F). Ignored if you pass explicit 'symbols'. ## `limit` (type: `integer`): Maximum number of futures contracts to emit. Useful for sampling or staying inside a budget. Set to 0 for no limit. ## Actor input object example ```json { "symbols": [ "GC=F", "CL=F", "HG=F", "ZC=F", "ES=F" ], "categories": [ "Energy", "Metals", "Grains", "Softs" ], "include_indices": false, "include_crypto_futures": false, "limit": 50 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "symbols": [ "GC=F", "CL=F", "HG=F", "ZC=F", "ES=F" ], "categories": [ "Energy", "Metals", "Grains", "Softs" ], "include_indices": false, "include_crypto_futures": false, "limit": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/commodity-futures-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "symbols": [ "GC=F", "CL=F", "HG=F", "ZC=F", "ES=F", ], "categories": [ "Energy", "Metals", "Grains", "Softs", ], "include_indices": False, "include_crypto_futures": False, "limit": 50, } # Run the Actor and wait for it to finish run = client.actor("nexgendata/commodity-futures-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "symbols": [ "GC=F", "CL=F", "HG=F", "ZC=F", "ES=F" ], "categories": [ "Energy", "Metals", "Grains", "Softs" ], "include_indices": false, "include_crypto_futures": false, "limit": 50 }' | apify call nexgendata/commodity-futures-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/commodity-futures-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "⚡ Commodity Futures Tracker — Energy, Metals, Grains", "description": "Track global commodity futures: WTI crude, Brent, gold, silver, copper, corn, wheat, soybeans, coffee, sugar, plus index and crypto futures. Bloomberg commodity data alternative for hedge funds, traders, miners. Pay-per-result.", "version": "0.0", "x-build-id": "vvZlTWI8jlnNV4YMW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~commodity-futures-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-commodity-futures-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~commodity-futures-tracker/runs": { "post": { "operationId": "runs-sync-nexgendata-commodity-futures-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~commodity-futures-tracker/run-sync": { "post": { "operationId": "run-sync-nexgendata-commodity-futures-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "symbols": { "title": "Specific Futures Symbols", "type": "array", "description": "Optional list of specific Yahoo Finance futures tickers to fetch (e.g., 'GC=F' gold, 'CL=F' WTI crude, 'HG=F' copper, 'ZC=F' corn, 'ES=F' S&P 500 futures). Leave empty to pull the full curated universe filtered by the categories below.", "default": [], "items": { "type": "string" } }, "categories": { "title": "Commodity Categories", "type": "array", "description": "Which commodity categories to include when no explicit symbols are supplied. Supported values: 'Energy', 'Metals', 'Grains', 'Livestock', 'Softs', 'Indices', 'Crypto'.", "default": [ "Energy", "Metals", "Grains", "Livestock", "Softs" ], "items": { "type": "string" } }, "include_indices": { "title": "Include Index Futures", "type": "boolean", "description": "When true, the curated universe also pulls equity-index futures (ES=F, NQ=F, YM=F, RTY=F). Ignored if you pass explicit 'symbols'.", "default": false }, "include_crypto_futures": { "title": "Include CME Crypto Futures", "type": "boolean", "description": "When true, the curated universe also pulls CME-listed crypto futures (BTC=F, ETH=F). Ignored if you pass explicit 'symbols'.", "default": false }, "limit": { "title": "Max Results", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of futures contracts to emit. Useful for sampling or staying inside a budget. Set to 0 for no limit.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```