{"openapi":"3.1.0","info":{"title":"SignalX API","summary":"SEC filing intelligence: AI research, semantic search and structured filing data.","description":"\nSEC EDGAR filing intelligence for developers: an AI research agent, semantic search over\nfiling text, and structured data (XBRL financials, Form 4 insider trades, 13F holdings,\n8-K events, activist stakes).\n\n**Authentication.** Send `Authorization: Bearer sk_live_...`. Create keys in the\n[API console](https://signal-x.app/api).\n\n**Billing.** Prepaid credits, 1 credit = $0.10. Chat costs 1 credit per 10K tokens\n(minimum 1), search 0.2 credits, data endpoints 0.1 credits. Failed requests are refunded.\n\n**Conventions.** Every response carries `X-Request-ID`. Errors use one envelope:\n`{\"error\": {\"type\", \"code\", \"message\", \"request_id\"}}`. Send `Idempotency-Key` on POST\nrequests so a retry is never charged twice.\n\nFull guide: https://signal-x.app/api-docs\n","termsOfService":"https://signal-x.app/terms","contact":{"name":"SignalX","url":"https://signal-x.app/api-docs"},"version":"4.1.0"},"servers":[{"url":"https://api.signal-x.app","description":"Production"}],"paths":{"/v1/chat":{"post":{"tags":["Research"],"summary":"Ask the research agent","description":"Runs the same agent as the SignalX app. It picks from 30 data tools (filings, XBRL financials,\ninsider trades, 13F holdings, 8-K events, activist stakes and more) and writes a cited answer.\n\nBilling: credits are reserved up front (20, or your whole balance if smaller), then settled to\nactual usage at 1 credit per 10K tokens (minimum 1). Failed or timed-out requests are refunded.","operationId":"api_chat_v1_chat_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unique key (8-128 chars) so a retried request is never charged twice.","title":"Idempotency-Key"},"description":"Unique key (8-128 chars) so a retried request is never charged twice."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"JSON answer, or `text/event-stream` when `stream` is true.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"402":{"description":"Not enough credits"},"409":{"description":"Idempotency-Key conflict"},"429":{"description":"Rate limit exceeded"},"503":{"description":"The agent or billing is temporarily unavailable (credits are returned)"},"504":{"description":"The answer took too long (credits are returned)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/search":{"post":{"tags":["Research"],"summary":"Semantic search across filings","description":"Vector search over AI summaries and filing sections, plus a short bullet summary of the matches.\nFaster and cheaper than `/v1/chat`: a flat 0.2 credits, returned if the search fails.","operationId":"api_search_v1_search_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unique key (8-128 chars) so a retried request is never charged twice.","title":"Idempotency-Key"},"description":"Unique key (8-128 chars) so a retried request is never charged twice."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Bad filter"},"402":{"description":"Not enough credits"},"404":{"description":"Company not found"},"503":{"description":"Search unavailable (credits returned)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/balance":{"get":{"tags":["Account"],"summary":"Credit balance","description":"Your remaining credits. Works with a zero balance, so you can check before topping up.","operationId":"api_balance_v1_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/usage":{"get":{"tags":["Account"],"summary":"Request log","description":"Your billed requests, newest first, with cursor pagination.","operationId":"api_usage_v1_usage_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Look-back window in days.","default":30,"title":"Days"},"description":"Look-back window in days."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Rows per page (1-100).","default":50,"title":"Limit"},"description":"Rows per page (1-100)."},{"name":"starting_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cursor from the previous page's `next_cursor`.","title":"Starting After"},"description":"Cursor from the previous page's `next_cursor`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}":{"get":{"tags":["Companies"],"summary":"Company overview","description":"Profile, recent filings of every form type, key XBRL financials and recent insider trades in one call.","operationId":"company_overview_v1_companies__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}/financials":{"get":{"tags":["Companies"],"summary":"XBRL financials","description":"Reported XBRL values per period (revenue, net income, EPS, margins, cash flow, balance sheet).","operationId":"company_financials_v1_companies__ticker__financials_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."},{"name":"filing_type","in":"query","required":false,"schema":{"enum":["all","10-K","10-Q","20-F"],"type":"string","description":"Quarterly (10-Q), annual (10-K/20-F) or both.","default":"all","title":"Filing Type"},"description":"Quarterly (10-Q), annual (10-K/20-F) or both."},{"name":"metrics","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated metrics, e.g. `revenue,net_income,eps`. Omit for all.","title":"Metrics"},"description":"Comma-separated metrics, e.g. `revenue,net_income,eps`. Omit for all."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Periods per metric.","default":5,"title":"Limit"},"description":"Periods per metric."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}/filings":{"get":{"tags":["Companies"],"summary":"Filing list","description":"Filings newest first. 8-K rows include their item titles (e.g. Item 2.02 results of operations).","operationId":"company_filings_v1_companies__ticker__filings_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."},{"name":"form_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["10-K","10-Q","8-K","20-F","6-K","13F-HR","4","SC 13D","SC 13D/A","SC 13G","SC 13G/A"],"type":"string"},{"type":"null"}],"description":"Only this form type.","title":"Form Type"},"description":"Only this form type."},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earliest filing date, `YYYY-MM-DD`.","title":"Date From"},"description":"Earliest filing date, `YYYY-MM-DD`."},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Latest filing date, `YYYY-MM-DD`.","title":"Date To"},"description":"Latest filing date, `YYYY-MM-DD`."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}/insider-trades":{"get":{"tags":["Companies"],"summary":"Insider trades (Form 4)","description":"Non-derivative Form 4 transactions, newest first: insider, title, code (P buy, S sale, ...), shares, price.","operationId":"company_insider_trades_v1_companies__ticker__insider_trades_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}/timeline":{"get":{"tags":["Companies"],"summary":"Event timeline","description":"8-K events, insider open-market trades and 13D/G stake filings for one company, in date order.","operationId":"company_timeline_v1_companies__ticker__timeline_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":1,"default":365,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/companies/{ticker}/prices":{"get":{"tags":["Companies"],"summary":"Daily closing prices","description":"Latest stored close, change over the window and period high/low. Always reports the as-of date.","operationId":"company_prices_v1_companies__ticker__prices_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK.","examples":["NVDA"],"title":"Ticker"},"description":"Ticker (e.g. `NVDA`, `BRK.B`) or 10-digit CIK."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/events":{"get":{"tags":["Market"],"summary":"8-K event feed","description":"Recent 8-K current reports across the market with item codes, an AI headline, and an AI-scored\nimportance (0-4, relative to company size) plus a specific event type such as `CEO change` or `M&A agreement`.","operationId":"events_feed_v1_events_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":14,"title":"Days"}},{"name":"items","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated 8-K item codes, e.g. `5.02` or `1.01,2.01`.","title":"Items"},"description":"Comma-separated 8-K item codes, e.g. `5.02` or `1.01,2.01`."},{"name":"tracked_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only the ~2,400 watchlist companies.","default":false,"title":"Tracked Only"},"description":"Only the ~2,400 watchlist companies."},{"name":"sort","in":"query","required":false,"schema":{"enum":["date","importance"],"type":"string","description":"`date` = newest first, `importance` = most important first.","default":"date","title":"Sort"},"description":"`date` = newest first, `importance` = most important first."},{"name":"min_importance","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":4,"minimum":0},{"type":"null"}],"description":"Only filings scored at least this (0 routine to 4 major).","title":"Min Importance"},"description":"Only filings scored at least this (0 routine to 4 major)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","pattern":"^(en|ko)$","description":"Language for AI one-liners: `en` or `ko`.","default":"en","title":"Language"},"description":"Language for AI one-liners: `en` or `ko`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/insiders/clusters":{"get":{"tags":["Market"],"summary":"Insider cluster buys","description":"Companies where several different insiders bought on the open market inside the window.","operationId":"insider_clusters_v1_insiders_clusters_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"default":90,"title":"Days"}},{"name":"min_insiders","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":2,"description":"Minimum distinct buyers.","default":3,"title":"Min Insiders"},"description":"Minimum distinct buyers."},{"name":"min_value","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Minimum total purchase value in USD.","default":250000,"title":"Min Value"},"description":"Minimum total purchase value in USD."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/insiders/top-buyers":{"get":{"tags":["Market"],"summary":"Largest insider buyers","description":"Biggest individual open-market buyers (Form 4 code P) across all companies.","operationId":"insider_top_buyers_v1_insiders_top_buyers_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}},{"name":"role","in":"query","required":false,"schema":{"enum":["insider","ceo_cfo","all"],"type":"string","description":"`insider` = officers and directors.","default":"insider","title":"Role"},"description":"`insider` = officers and directors."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":15,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/smart-money":{"get":{"tags":["Market"],"summary":"Smart Money 13F moves","description":"What 17 curated conviction and activist managers bought and sold in their latest 13F filings.","operationId":"smart_money_v1_smart_money_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"enum":["smart","conviction","activist"],"type":"string","description":"`smart` = conviction + activist funds.","default":"smart","title":"Scope"},"description":"`smart` = conviction + activist funds."},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["buying","holders","net_flow","selling"],"type":"string","default":"buying","title":"Sort By"}},{"name":"names","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated stocks to look up, e.g. `AMZN,NVDA`.","title":"Names"},"description":"Comma-separated stocks to look up, e.g. `AMZN,NVDA`."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":15,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/activists":{"get":{"tags":["Market"],"summary":"Activist campaigns (13D)","description":"SC 13D activist and 5%+ stake filings by target, with stake changes and stated intent.","operationId":"activist_campaigns_v1_activists_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"default":180,"title":"Days"}},{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Target company ticker.","title":"Ticker"},"description":"Target company ticker."},{"name":"filer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filer name, e.g. `ELLIOTT`.","title":"Filer"},"description":"Filer name, e.g. `ELLIOTT`."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","pattern":"^(en|ko)$","description":"Language for AI one-liners: `en` or `ko`.","default":"en","title":"Language"},"description":"Language for AI one-liners: `en` or `ko`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/sectors":{"get":{"tags":["Market"],"summary":"Sector activity","description":"Per sector: insider buying vs selling, 8-K red flags and activist stakes over the window.","operationId":"sector_overview_v1_sectors_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"default":90,"title":"Days"}},{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"enum":["Information Technology","Health Care","Financials","Industrials","Consumer Discretionary","Consumer Staples","Energy","Materials","Utilities","Real Estate","Communication Services","Agriculture"],"type":"string"},{"type":"null"}],"description":"Drill into one sector.","title":"Sector"},"description":"Drill into one sector."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/health":{"get":{"tags":["Status"],"summary":"Liveness check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}}},"components":{"schemas":{"BalanceResponse":{"properties":{"balance_credits":{"type":"number","title":"Balance Credits","description":"Credits left (1 credit = $0.10)."},"balance_usd":{"type":"number","title":"Balance Usd"},"total_used_credits":{"type":"number","title":"Total Used Credits"},"total_charged_usd":{"type":"number","title":"Total Charged Usd","description":"Total you have paid for credits."}},"type":"object","required":["balance_credits","balance_usd","total_used_credits","total_charged_usd"],"title":"BalanceResponse"},"ChatRequest":{"properties":{"message":{"type":"string","maxLength":4000,"minLength":1,"title":"Message","description":"Your research question, in English or Korean."},"language":{"type":"string","pattern":"^(en|ko)$","title":"Language","description":"Answer language: `en` or `ko`.","default":"en"},"request_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Request Id","description":"Optional correlation ID, echoed in `X-Request-ID` and your usage log."},"stream":{"type":"boolean","title":"Stream","description":"`true` streams Server-Sent Events instead of one JSON response.","default":false}},"type":"object","required":["message"],"title":"ChatRequest","examples":[{"language":"en","message":"What did Nvidia insiders do in the last 90 days?"}]},"ChatResponse":{"properties":{"answer":{"type":"string","title":"Answer","description":"Markdown answer grounded in SEC filings."},"citations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Citations","description":"Filings the answer relied on."},"tool_calls":{"items":{"$ref":"#/components/schemas/ToolCall"},"type":"array","title":"Tool Calls","description":"Data tools the agent ran, in order."},"usage":{"$ref":"#/components/schemas/ChatUsage"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["answer","usage"],"title":"ChatResponse"},"ChatUsage":{"properties":{"credits_used":{"type":"number","title":"Credits Used","description":"Credits charged for this answer (1 credit per 10K tokens, minimum 1)."},"credits_reserved":{"type":"number","title":"Credits Reserved","description":"Credits held while the answer ran; the unused part is returned.","default":0},"credits_remaining":{"type":"number","title":"Credits Remaining","description":"Balance after this request. `-1` for unlimited accounts."}},"type":"object","required":["credits_used","credits_remaining"],"title":"ChatUsage"},"DataResponse":{"properties":{"object":{"type":"string","title":"Object","description":"What `data` holds, e.g. `company`, `financials`, `event_list`."},"data":{"title":"Data","description":"Result payload. Same JSON the SignalX research agent reads."},"citations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Citations","description":"SEC filings behind the data, when available."},"usage":{"$ref":"#/components/schemas/DataUsage"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["object","data","usage"],"title":"DataResponse"},"DataUsage":{"properties":{"credits_used":{"type":"number","title":"Credits Used"},"credits_remaining":{"type":"number","title":"Credits Remaining"}},"type":"object","required":["credits_used","credits_remaining"],"title":"DataUsage"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SearchRequest":{"properties":{"query":{"type":"string","maxLength":1000,"minLength":1,"title":"Query","description":"What to look for, in plain language."},"cik":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cik","description":"Limit to one company by CIK."},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker","description":"Limit to one company by ticker (e.g. `AAPL`)."},"section_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Name","description":"Limit to one section, e.g. `risk_factors`, `mda`, `business`."},"form_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Type","description":"Limit to one form type, e.g. `10-K`, `10-Q`, `8-K`."},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Earliest filing date, `YYYY-MM-DD`."},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Latest filing date, `YYYY-MM-DD`."},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","description":"Results to return (1-20).","default":10},"language":{"type":"string","pattern":"^(en|ko)$","title":"Language","description":"Summary language: `en` or `ko`.","default":"en"}},"type":"object","required":["query"],"title":"SearchRequest","examples":[{"form_type":"10-K","limit":5,"query":"supply chain risk from Taiwan"}]},"SearchResponse":{"properties":{"summary":{"type":"string","title":"Summary","description":"Short bullet summary of the matches (empty when nothing matched)."},"results":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Results"},"usage":{"$ref":"#/components/schemas/SearchUsage"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["summary","results","usage"],"title":"SearchResponse"},"SearchResult":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"cik":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cik"},"form_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Type"},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Date"},"accession_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession Number"},"section_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Name"},"similarity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Similarity","description":"Cosine similarity of the matched passage (0-1)."},"relevance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relevance","description":"AI-judged probability (0-1) that the passage helps answer your query. Results are ordered by it."},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type","description":"`summary` (AI bullet summary) or `raw` (filing text)."},"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"}},"additionalProperties":true,"type":"object","title":"SearchResult"},"SearchUsage":{"properties":{"credits_used":{"type":"number","title":"Credits Used"},"credits_remaining":{"type":"number","title":"Credits Remaining"}},"type":"object","required":["credits_used","credits_remaining"],"title":"SearchUsage"},"ToolCall":{"properties":{"tool":{"type":"string","title":"Tool"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input"}},"type":"object","required":["tool"],"title":"ToolCall"},"UsageResponse":{"properties":{"object":{"type":"string","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/UsageRow"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `starting_after` to get the next page."},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Count","description":"All requests in the window."},"requests":{"items":{"$ref":"#/components/schemas/UsageRow"},"type":"array","title":"Requests","description":"Deprecated alias of `data`."},"count":{"type":"integer","title":"Count","description":"Rows in this page."},"total_calls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Calls","description":"Deprecated alias of `total_count`."}},"type":"object","required":["data","has_more","requests","count"],"title":"UsageResponse"},"UsageRow":{"properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"},"endpoint":{"type":"string","title":"Endpoint"},"credits_used":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Credits Used"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["endpoint","created_at"],"title":"UsageRow"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_...","description":"Your SignalX API key."}}},"tags":[{"name":"Research","description":"AI agent answers and semantic search over filings."},{"name":"Companies","description":"One company: overview, financials, filings, insiders, timeline, prices."},{"name":"Market","description":"Market-wide signals: 8-K events, insider clusters, Smart Money, activists, sectors."},{"name":"Account","description":"Credit balance and request log."},{"name":"Status","description":"Service health."}]}