# CBOE US Options Daily Volume Scraper (`parseforge/cboe-options-volume-scraper`) Actor Pull CBOE daily US options market volume by symbol with total\_volume, call\_volume, put\_volume, put\_call\_ratio, date, and exchange. Pick a specific trading day or grab the latest available. Useful for sentiment indicators, options flow research, and equity derivatives studies. - **URL**: https://apify.com/parseforge/cboe-options-volume-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $7.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ”Ž CBOE US Options Daily Market Volume Scraper > ๐Ÿš€ **Export cboe us options daily market volume data in seconds. Clean, structured records ready for CSV, Excel, JSON, or XML.** > ๐Ÿ•’ **Last updated:** 2026-05-29 ยท **๐Ÿ“Š 9 fields** per record ยท Public data ยท Production-grade The CBOE US Options Daily Market Volume Scraper pulls public data and normalizes it into a flat, analytics-ready dataset. No login, no fragile DOM parsing โ€” just clean records pushed straight to an Apify dataset you can download or pipe to your stack. Scrape CBOE daily US options market statistics including total volume, call volume, put volume, put/call ratios per exchange and venue from cboe.com. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | ๐Ÿ“Š Analysts | Build research datasets in seconds | | ๐Ÿค– Engineers | Skip the API client, get clean rows | | ๐Ÿ“ฐ Journalists | Verify figures with one click | | ๐Ÿข Operations teams | Schedule daily snapshots | | ๐ŸŽ“ Students & researchers | Free-tier friendly data access | | ๐Ÿ‘ฉโ€๐Ÿ’ป Developers | Drop into BigQuery, Snowflake, Postgres | ### ๐Ÿ“‹ What the CBOE US Options Daily Market Volume does - Calls the public source endpoint with the parameters you supply. - Parses the response and flattens each record into a single row. - Casts numeric fields to numbers so they import cleanly into Excel and BI tools. - Surfaces upstream errors and rate-limit notes as a single-row `error` record instead of crashing. - Exports as CSV, Excel, JSON, JSONL, XML, RSS, or HTML. > ๐Ÿ’ก **Why it matters:** the source response is normalized into clean snake_case fields. Drops straight into pandas, BigQuery, or a Google Sheet without manual cleanup. ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon._ ### โš™๏ธ Input
FieldTypeRequiredDescription
datestringNoDate in YYYY-MM-DD format. Leave empty for latest available trading day.
maxItemsintegerNoFree users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
**Example:** ```json { "date": "", "maxItems": 10 } ```` > โš ๏ธ **Good to Know:** the actor returns clean records with numeric casting applied. Free-tier runs are capped at 10 items; paid plans unlock up to 1,000,000. ### ๐Ÿ“Š Output Each record is a flat object. `error` is always last. | Field | Type | Description | |---|---|---| | ๐Ÿ”ฃ Symbol `symbol` | string | See dataset. | | ๐Ÿ›๏ธ Exchange `exchange` | string | See dataset. | | ๐Ÿ“Š Total Volume `total_volume` | string | See dataset. | | ๐Ÿ“ˆ Call Volume `call_volume` | string | See dataset. | | ๐Ÿ“‰ Put Volume `put_volume` | string | See dataset. | | โš–๏ธ P/C Ratio `put_call_ratio` | string | See dataset. | | ๐Ÿ“… Date `date` | string | See dataset. | | ๐Ÿ•’ Scraped At `scrapedAt` | string | See dataset. | | โŒ Error `error` | string | Set if the upstream response was an error or rate-limit. | ### โœจ Why choose this Actor | ๐Ÿ†“ | Works with public endpoints, no login. | | ๐Ÿงน | Normalized snake\_case keys ready for BI. | | ๐Ÿ”ข | Auto-casts numeric strings to real numbers. | | ๐Ÿ›Ÿ | Errors and rate limits surface as clean `error` records. | | ๐Ÿ”Œ | Configurable input โ€” search, filter, page through. | | ๐Ÿ’พ | Push to dataset for instant CSV / Excel / JSON / XML / RSS / HTML export. | ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Setup time | Clean keys? | Numeric casting? | Rate-limit handling? | |---|---|---|---|---| | Roll your own fetch | 30 min + | โŒ | โŒ | โŒ | | Vendor client library | 1 hr install + script | โœ… | partial | partial | | **This Actor** | 5 sec, no install | โœ… | โœ… | โœ… | ### ๐Ÿš€ How to use 1. Click **Try for free**. 2. Configure the input (defaults work for a quick test). 3. Click **Start**. Download your dataset as CSV, Excel, JSON, or XML within seconds. ### ๐Ÿ’ผ Business use cases **๐Ÿ“Š Research & analysis.** Pull data into a CSV, feed pandas, run your analysis. **๐Ÿข Operations dashboards.** Schedule daily runs and pipe results to your BI tool. **๐Ÿ“ฐ Newsroom fact-checking.** Verify figures for a story in 30 seconds. **๐Ÿค– ML feature engineering.** Build a clean training set without writing API client code. ### ๐Ÿ”Œ Automating CBOE US Options Daily Market Volume - **Make / Zapier**: trigger this actor on a schedule, push results to Airtable, Google Sheets, or Slack. - **Cron schedule**: native Apify scheduler โ€” run every weekday at 16:30. - **Webhooks**: get a POST to your endpoint the moment a run finishes. - **Pipe to BigQuery / Snowflake / Postgres**: native Apify integrations. ### ๐ŸŒŸ Beyond business use cases **๐ŸŽ“ Education.** Teach a class with real-world public data instead of synthetic examples. **๐Ÿงช Personal research.** Track your own watchlist, compute custom indicators. **๐Ÿค Non-profit & open data.** Build public dashboards without writing client code. **๐Ÿงฐ Tinkering & prototyping.** Spin up a feed in 5 seconds to test a new dashboard or bot idea. ### ๐Ÿค– Ask an AI assistant about this scraper Pop this README into ChatGPT, Claude, or any AI assistant and ask it to map your workflow to the actor's inputs. The schema, examples, and field list above contain everything an LLM needs. ### โ“ Frequently Asked Questions **โ“ Do I need an account?** A free Apify account works โ€” [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp). **โ“ Is there a rate limit?** The actor surfaces upstream rate-limit notes as a clean `error` record. **โ“ Can I schedule runs?** Yes, use Apify's native scheduler or hook this up to Make / Zapier / cron. **โ“ Are values cast to numbers?** Yes, numeric fields are auto-cast so they import cleanly. **โ“ How do you handle errors?** A single record with `error` populated is pushed instead of throwing. **โ“ What format can I download?** CSV, Excel, JSON, JSONL, XML, RSS, or HTML. **โ“ Will the schema change?** Core fields are stable, source-specific fields are passed through as-is. **โ“ Does this require an API key?** No, it uses public endpoints. **โ“ Can I use it commercially?** Yes, subject to the source's terms of service. **โ“ What if no results come back?** A diagnostic `error` record is pushed. ### ๐Ÿ”Œ Integrate with any app Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST API or webhook endpoint. ### ๐Ÿ”— Recommended Actors | Actor | What it does | |---|---| | [ParseForge Alpha Vantage Scraper](https://apify.com/parseforge/alpha-vantage-public-scraper) | Stocks, FX, crypto, indicators. | | [ParseForge OurAirports Scraper](https://apify.com/parseforge/ourairports-scraper) | Global airport database. | | [ParseForge NBA Stats Scraper](https://apify.com/parseforge/nba-stats-scraper) | Player and team stats from NBA.com. | | [ParseForge CurseForge Mods Scraper](https://apify.com/parseforge/curseforge-mods-scraper) | Public mod metadata from CurseForge. | > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for 900+ production-grade scrapers across business intelligence, real estate, e-commerce, sports, finance, and public records. *** **Disclaimer:** This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp). # Actor input Schema ## `date` (type: `string`): Date in YYYY-MM-DD format. Leave empty for latest available trading day. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/cboe-options-volume-scraper").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 = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/cboe-options-volume-scraper").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 '{ "maxItems": 10 }' | apify call parseforge/cboe-options-volume-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/cboe-options-volume-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CBOE US Options Daily Volume Scraper", "description": "Pull CBOE daily US options market volume by symbol with total_volume, call_volume, put_volume, put_call_ratio, date, and exchange. Pick a specific trading day or grab the latest available. Useful for sentiment indicators, options flow research, and equity derivatives studies.", "version": "0.1", "x-build-id": "tpfy06sghRR1sw1tK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~cboe-options-volume-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-cboe-options-volume-scraper", "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/parseforge~cboe-options-volume-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-cboe-options-volume-scraper", "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/parseforge~cboe-options-volume-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-cboe-options-volume-scraper", "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": { "date": { "title": "Date", "type": "string", "description": "Date in YYYY-MM-DD format. Leave empty for latest available trading day." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } } } } } } } } } ```