/api/v1/filings/{id}/newsGETThe named filing plus articles whose text sits near its title.
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: headerQuery Parameters
min_similarity?number
Min:
0Max: 1page?integer
Default:
1Min: 1per_page?integer
Default:
100Min: 1Max: 500recency_half_life_days?number
Recency half-life in days for the relevance-recency blend applied to the ranking: a result's score is its similarity times 0.5^(age_days / this).
Min:
0Response
200 · The source filing and related articles
filing *object
Show 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)
data *object[]
Show item properties
article_id *string
similarity *number (double)
Cosine similarity of the best embedding match.
title?stringnull
url?stringnull
image_url?stringnull
published_date?string,null (date-time)
source?stringnull
Where the article was published: the publisher's name when known, otherwise the site's hostname.
via_market_id?stringnull
The market this article matched most closely. Present on index news (the winning constituent market, including a constituent rate's source market) and on rate news when a source market beat the rate itself.
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 filing id
Unknown filing id