{ "openapi": "3.0.1", "info": { "title": "Futures Roll Calendar & Front-Month API (CME)", "description": "Current front-month contract, roll date, last trading day, first notice day, tick value and broker symbol formats for ES, NQ, CL, GC, ZN, 6E and 20+ CME futures. Deterministic, no scraping, built for trading bots and AI agents.", "version": "1.0", "x-build-id": "vR2FVvnHKTL29TzeN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vikingtrading~futures-roll-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vikingtrading-futures-roll-calendar", "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/vikingtrading~futures-roll-calendar/runs": { "post": { "operationId": "runs-sync-vikingtrading-futures-roll-calendar", "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/vikingtrading~futures-roll-calendar/run-sync": { "post": { "operationId": "run-sync-vikingtrading-futures-roll-calendar", "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": { "mode": { "title": "Mode", "enum": [ "active", "schedule", "holidays" ], "type": "string", "description": "active: one row per symbol with the contract to trade now, the next contract and the expiring one. schedule: the next N contracts per symbol with all dates. holidays: the exchange holiday list for a year.", "default": "active" }, "symbols": { "title": "Futures root symbols", "type": "array", "description": "Root symbols such as ES, MES, NQ, MNQ, RTY, YM, CL, NG, RB, HO, GC, MGC, SI, HG, ZN, ZB, ZF, TN, UB, 6E, M6E, 6B, 6J, 6A, 6S. Up to 50 per run. Unsupported symbols are returned as free error rows.", "items": { "type": "string" } }, "asOf": { "title": "As-of date", "type": "string", "description": "Date to evaluate (YYYY-MM-DD). Leave empty for today in Chicago time. Use past dates for backtests." }, "contractsAhead": { "title": "Contracts ahead (schedule mode)", "minimum": 1, "maximum": 24, "type": "integer", "description": "How many upcoming contracts to list per symbol in schedule mode.", "default": 4 }, "year": { "title": "Year (holidays mode)", "minimum": 2000, "maximum": 2100, "type": "integer", "description": "Year for the holiday list. Defaults to the year of the as-of date." }, "rollBusinessDaysBeforeExpiry": { "title": "Custom roll offset (business days)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Optional. Overrides the default roll rule for all symbols: roll this many business days before the last trading day (equity index, FX, energy) or before the first notice day (metals, Treasuries)." }, "extraHolidays": { "title": "Extra closures", "type": "array", "description": "Optional unscheduled exchange closures (YYYY-MM-DD), e.g. a national day of mourning. They are excluded from business-day counting.", "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }