/api/v1/public/indices/{id}/filingsGETUp to 3 CFTC filings related through the markets this index currently includes. Each filing's status date is in the last 90 days, and each match clears the relevance floor. Ordered by similarity. via_market_id and via_market_question name the market that carried the match. A known index with no close filing returns an empty list. Paid plans return the full ranked list, including older filings.
Query Parameters
per_page?integer
Filings to return (1-3).
Default:
3Min: 1Max: 3Response
200 · Related filings
data?object[]
Show item properties
filing_id *integer (int64)
CFTC filing id.
similarity *number (double)
Cosine similarity of the title embedding match.
title *string
Product name on DCM product filings, otherwise the filing description.
org_code *string
Submitting organization code, for example KEX or CME.
feed *"ptc_dcm_rules" | "dcm_products" | "dco" | "dco_rules"
CFTC registry this filing belongs to.
status *string
Current CFTC status, for example Certified or 10 Day Review.
status_date *string (date)
Date of the current status.
description?stringnull
Filing description from the CFTC listing.
product_name?stringnull
Product name, when the registry carries one.
product_type?stringnull
category?stringnull
subcategory?stringnull
products_affected?stringnull
remarks?stringnull
receipt_date?string,null (date)
doc_count?integer
Number of attachments listed on the filing.
predicted_effective_date?string,null (date)
via_market_id?stringnull
The constituent market this filing matched most closely. Present only on index filings, where results are drawn from the markets the index currently includes.
via_market_question?stringnull
The question text of that market.
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 ranked matches (at most 10,000).
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.404 · Unknown index id
Unknown index id
503 · The similarity read exceeded its time budget. Retry in a few seconds.
The similarity read exceeded its time budget. Retry in a few seconds.