Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

List industry filings

/api/v1/filingsGET
Full CFTC industry-filings catalog, newest status date first, or by sort/sort_dir.
Authorization
bearerAuth *Bearer <token>
Session token from the app, or an API key (the ak_ prefix), sent as a Bearer token or an ?api_key= query parameter.. Token in: header
Query Parameters
feed?"ptc_dcm_rules" | "dcm_products" | "dco" | "dco_rules"
org?string
status?string
search?string
Relevance-ranked text search over the organization, description, product name and type, affected products, and filing id.
last_seen_days?integer
Only filings not observed on a CFTC listing in this many days.
Min: 1
page?integer
Default: 1Min: 1
per_page?integer
Default: 100Min: 1Max: 500
sort?"status_date" | "received" | "first_seen" | "last_seen" | "org"
Sort key.
Default: "status_date"
sort_dir?"asc" | "desc"
Default: "desc"
Response
200 · Paged filings
data *object[]
Show item properties
id *integer (int64)
CFTC filing id.
title *string
Product name on DCM product filings, otherwise the filing description.
feed *"ptc_dcm_rules" | "dcm_products" | "dco" | "dco_rules"
org_code *string
description?string
Rules-feed description. Omitted on DCM product and DCO rows; use title.
product_name?string
DCM product name. Omitted on rules and DCO rows; use title.
product_type?string
DCM product type. Omitted on feeds that do not list one.
category?string
DCM product category. Omitted on rules and DCO rows.
subcategory?string
DCM product subcategory. Omitted on rules and DCO rows.
products_affected?string
PTC listing column. CFTC leaves it blank; omitted when empty.
remarks?string
Present on DCO registrations. Omitted when CFTC published none.
receipt_date?string (date)
Official receipt date on rules feeds. Omitted on DCM products and DCO rows; CFTC does not publish one there.
status *string
status_date *string (date)
doc_count *integer
predicted_effective_date?string (date)
Business-day estimate for a pending rules filing that has a receipt date. Omitted once the filing is no longer pending, and on feeds with no receipt date.
first_seen_at?string (date-time)
last_seen_at?string (date-time)
meta *object
Show properties
total?integernull
Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the best 1,000 matches. A match outside that set is omitted.
page?integer
The 1-based page number this response covers.
per_page?integer
Maximum number of items on a page. The last page may hold fewer.
total_pages?integernull
Total number of pages available at the current per_page. null whenever total is null; page using has_next.
has_next?boolean
True when a page exists after this one.
has_prev?boolean
True when this is not the first page.
total_capped?boolean
True when total and total_pages reflect the server's counting ceiling rather than the exact matched count: the real set is at least total large. Render such totals as a lower bound (for example "10,000+"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag.
503 · The read exceeded its time budget, or the database cancelled it during recovery. `error` is `service_unavailable`. `message` is `The request exceeded the database time budget. Retry in a few seconds.` or `The database cancelled this read during recovery. Retry in a few seconds.` Wait `Retry-After` seconds before retrying.
error?string
Stable, machine-readable code identifying the failure; branch on this rather than on message. One of bad_request, unauthorized, forbidden, not_found, conflict, service_unavailable, upstream_error, service_error, or internal_error.
message?string
Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld.
Request example
curl -X GET "https://api.adjacent.markets/api/v1/filings" \
  -H "Authorization: Bearer <token>"