# CFTC adapter reference

Use this as compact context for the CFTC adapter in bluedoor.

Primary URLs:

- Landing page: https://bluedoor.sh/adapters/cftc
- Docs: https://bluedoor.sh/adapters/cftc/docs
- OpenAPI JSON: https://bluedoor.sh/adapters/cftc/docs/openapi.json
- bluedoor adapter API base URL: https://api.bluedoor.sh/adapters/cftc/v1
- Current source API host: https://api.cotfin.bluedoor.sh
- Source health: https://api.cotfin.bluedoor.sh/v1/health
- Source catalog: https://api.cotfin.bluedoor.sh/v1/endpoints

Role:

- Adapter ID: cotfin
- Upstream: cftc.gov
- Summary: Official CFTC Commitments of Traders routes with report-family and commodity hierarchy support.
- Fit: Use this adapter when CFTC positioning data or report-family routing is needed directly.
- Adapters are not standalone bluedoor products. They are source-native connectors that power larger APIs, especially Financial Data.

Coverage:

- Commitments of Traders reports
- Report families
- CFTC product hierarchy
- SoQL-style filters

Representative routes:

- GET /v1/product-hierarchy: Product hierarchy
  Example: https://api.cotfin.bluedoor.sh/v1/product-hierarchy?limit=3
- GET /v1/report-families: Families
  Example: https://api.cotfin.bluedoor.sh/v1/report-families
- GET /v1/reports/{family}: Rows
  Example: https://api.cotfin.bluedoor.sh/v1/reports/tff-futures-only?limit=3

Examples:

```bash
curl "https://api.bluedoor.sh/adapters/cftc/v1/health"
curl "https://api.bluedoor.sh/adapters/cftc/v1/reports/tff-futures-only"
curl "https://bluedoor.sh/adapters/cftc/docs/openapi.json"
```