openbb-cftc
The mission of the Commodity Futures Trading Commission (CFTC) is to promote the integrity, resilience, and vibrancy of the U.S. derivatives markets through sound regulation.
Decision gist · record as of 2026-08-14
Yes, if you need CFTC Commitment of Traders data and are comfortable with AGPL-3.0 licensing. The package is actively maintained, has low install friction, and integrates cleanly into the OpenBB ecosystem. No known vulnerabilities. Consider it essential for derivatives market analysis; skip it if AGPL licensing conflicts with your project or if you need a standalone tool outside OpenBB.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10–3.14.
- Optional: free Socrata account and app_token to avoid IP throttling; set CFTC_APP_TOKEN environment variable if using one.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
AGPL-3.0-only (agpl) — Licensed under AGPL-3.0-only, which requires derivative works and modifications to be open-sourced under the same license. Suitable for internal tools and open-source projects; review carefully if you plan to distribute proprietary software.
last release 2026-06-24 (51 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 91,126 downloads/mo, #13,538 on PyPI
Alternatives
Verify before relying
pip install openbb-cftc
openbb-build
from openbb import obb
results = obb.cftc.cot_search(query="gold")
report = obb.cftc.cot(code="CFTC_088695", measure="percent_of_oi", limit=4)- Exact throttling behavior and rate limits when using IP address without app_token
- Performance characteristics and response times for large historical queries
- Whether all four report types (Legacy, Disaggregated, Financial, Supplemental) are fully implemented in this version
What it is and what it does
openbb-cftc is an extension to the OpenBB platform that wraps the CFTC Commitment of Traders database, exposing it through a Python API and optional REST server. It lets you search for commodity contracts by name and retrieve historical open-interest data broken down by trader classification (commercial, non-commercial, managed money, etc.) across different report types.
The package depends on openbb-core and openbb-platform-api, integrating into the OpenBB ecosystem as a router module with two endpoints: `cot_search` for finding contracts and `cot` for fetching reports. Data can be returned as DataFrames or accessed via REST. No credentials are required, though an optional free Socrata app_token can be set to avoid IP-based throttling.
Use it for
- Search for specific commodity futures contracts (e.g., gold, crude oil) and retrieve their full historical positioning data
- Analyze trader sentiment and positioning trends across commercial, non-commercial, and other trader classes
- Build dashboards or monitoring systems using the REST API to track open interest and trader classification changes
- Compare positioning across different report types (Legacy, Disaggregated, Financial, Supplemental) for the same contract
- Integrate CFTC data into quantitative trading or research workflows via Python DataFrames
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need CFTC Commitment of Traders data and are comfortable with AGPL-3.0 licensing.
The package is actively maintained, has low install friction, and integrates cleanly into the OpenBB ecosystem. No known vulnerabilities. Consider it essential for derivatives market analysis; skip it if AGPL licensing conflicts with your project or if you need a standalone tool outside OpenBB.
Install
openbb-cftc on PyPI
Before you install
Low install friction with a pure-Python wheel. Actively maintained as of 51 days ago. Requires running `openbb-build` after installation to set up static assets, and optionally `openbb-api` to start a REST server.
Requires Python 3.10–3.14. Optional: free Socrata account and app_token to avoid IP throttling; set CFTC_APP_TOKEN environment variable if using one.
License in practice
Licensed under AGPL-3.0-only, which requires derivative works and modifications to be open-sourced under the same license. Suitable for internal tools and open-source projects; review carefully if you plan to distribute proprietary software.
Quickstart
pip install openbb-cftc
openbb-build
from openbb import obb
results = obb.cftc.cot_search(query="gold")
report = obb.cftc.cot(code="CFTC_088695", measure="percent_of_oi", limit=4)Verify before relying
- Exact throttling behavior and rate limits when using IP address without app_token
- Performance characteristics and response times for large historical queries
- Whether all four report types (Legacy, Disaggregated, Financial, Supplemental) are fully implemented in this version
Package facts
| License | AGPL-3.0-only agpl |
| Python support | Supports the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesopenbb-coreopenbb-platform-api |
| Maintenance | Actively maintained 51 days since the last release |
| First released | |
| Downloads | 91,126 / month, #13,538 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: GNU Affero General Public License v3Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: openbb_cftc-1.4.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “CFTC commitment of traders data”
- openbb-cftcProvides access to CFTC Commitment of Traders data through a Python…
- ckzgProvides Python bindings to C-KZG-4844, a cryptographic library…
- pybitpybit is the official Python connector for Bybit's HTTP and WebSocket…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also openbb-tradingeconomics · openbb-benzinga · openbb-derivatives · openbb-regulators · openbb-crypto · openbb-fmp · openbb-yfinance · openbb-commodity · openbb-etf · openbb-index