Filings

Use the filings API to track CFTC industry submissions, certifications, and rule changes. Adjacent stores each filing, its status history, attachment text, and links to related markets and news.

What you can do

Browse the full filing catalog with filters and relevance-ranked search.
Use the public tier to browse filings from the last 90 days.
Follow new filings, status changes, and added attachments.
Read the action history for one filing.
Read extracted markdown from stored attachments.
Find related markets, news, and similar filings.

The public tier covers filings whose status date is in the last 90 days. Use an API key with the org:filings:read scope for the full catalog, historical filings, change events, and related-record endpoints.

Set ADJ_TOKEN to an API key before running these examples. See Authentication.

Browse recent filings

Start with the public list when you want recent filings without authentication. It includes the same core filing shape and returns the newest status dates first.

1curl "https://api.adjacent.markets/api/v1/public/filings?per_page=20"

Use the filters endpoint to populate feed, organization, and status filters.

1curl "https://api.adjacent.markets/api/v1/public/filings/filters"

Each filing has an id, title, feed, org_code, status, status_date, and doc_count. The feed tells you which CFTC registry provided the row.

Search the full catalog

Use the authenticated list for historical filings and relevance-ranked search. Search checks the organization, description, product name and type, affected products, and filing id.

12curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/filings?search=bitcoin&per_page=20"

Follow filing changes

The change feed lets you keep a local record current. Save the highest seq from each response, then pass it as since_seq on the next request.

12curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/filings/events?since_seq=100"

The feed reports first sightings, status changes, and later attachments.

Use the event kind to decide what to refresh. A status change updates the filing record. A documents-added event means you can request the attachment text again.

Read a filing and its history

Use the filing id from a list or event response to fetch the filing, its action history, or the text extracted from its attachments.

12345678curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/filings/FILING_ID"

curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/filings/FILING_ID/actions"

curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/filings/FILING_ID/markdown"

The actions endpoint returns the filing's history in oldest-first order. The markdown endpoint returns the filing and the extracted text for its stored attachments.

Connect filings to other data

Use the related endpoints to move between a filing and the markets, articles, or similar filings connected to it.

See the API reference for full schemas.