search_filings

com.twmarketdata/tw-market-data · Verify this server

Semantic search over MOPS filings, financial-statement notes and company news. Answers questions a keyword filter cannot: "what risks did this company disclose this quarter?", "which companies mentioned CoWoS capacity expansion?" — matching on MEANING, so a paragraph that never uses your exact words still ranks. ★ POINT-IN-TIME: pass `as_of` (YYYY-MM-DD). Chunks are filtered `published_at <= as_of` in SQL BEFORE ranking, so a backtest cannot retrieve a filing that did not exist yet. `meta.as_of_applied` echoes the cutoff that actually ran — check it. **Without `as_of` the results include the most recent filings and are look-ahead UNSAFE for backtesting**; the response says so in `meta.warnings`. ★ REFERENCE CONTEXT, NOT AUTHORITY. Every hit carries `source`, `source_tier` ("official" = MOPS/exchange, "third_party" = press) and a `url`. Read the chunk and judge it yourself; the ranking is similarity, not importance, and similarity is not evidence. **Nothing here is investment advice** (`not_investment_advice: true`). ★ A ticker you asked about that returns nothing appears in `coverage.missing` with a reason. That means NOTHING IS INDEXED for it under those filters — it does NOT mean the company disclosed nothing. Do not fill the gap. Args: query: what to look for, in Chinese or English (e.g. '匯率風險', 'CoWoS capacity'). tickers: restrict to these codes, e.g. ['2330','2317']. doc_type: e.g. 'mops_major_event', 'financial_note', 'company_news'. as_of: knowledge-time cutoff 'YYYY-MM-DD' — use it for anything backtest-shaped. source_tier: 'official' to exclude third-party press. limit: <= 100. Returns: {data:[{ticker,doc_type,published_at,source,source_tier,url,chunk_text,similarity}], meta:{as_of_applied,point_in_time_safe,embedding_model,warnings,query_id}, provenance:{...}, coverage:{requested,returned,missing,reason}, freshness:{...}}