{"openapi":"3.1.0","info":{"title":"Ultralayer API","summary":"Ultralayer API","description":"Ultralayer API","version":"0.1.0"},"servers":[{"url":"https://api.ultralayer.ai","description":"Ultralayer Production Server"}],"paths":{"/v0/search/semantic_search":{"post":{"tags":["V0","Search"],"summary":"Semantic Search","description":"Point-in-time and utility-filtered passage retrieval over Ultralayer's financial corpus (1-8 queries).","operationId":"semantic_search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemanticSearchParams"}}},"required":true},"responses":{"200":{"description":"Semantic search results at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SemanticSearchResult"},"type":"array","title":"Response 200 Semantic Search"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/search/identify_stakeholders":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Identify Stakeholders","description":"Identify key stakeholders for a query, with optional context and instructions. Commonly ~2 minutes; call once. **For Chat Agents**: [If a user is waiting on this turn, tell them it takes ~2 minutes and get explicit approval before calling. If no one is waiting (one-shot / autonomous), call and wait.]","operationId":"identify_stakeholders","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderIdentificationParams"}}},"required":true},"responses":{"200":{"description":"Stakeholder identification response at detail=full.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderIdentificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/identify_stakeholders.html"}},"/v0/search/screen_stocks":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Screen Stocks","description":"Find the public companies most exposed to a theme, event or trend described in plain language.","operationId":"screen_stocks","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenParams"}}},"required":true},"responses":{"200":{"description":"Screen response at detail=full.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/screen_stocks.html"}},"/v0/search/search_developments":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Search Developments","description":"Search for developments semantically (or not). Various filters available: timestamp, development type, stakeholder impact, symbols, and more.","operationId":"search_developments","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevelopmentSearchParams"}}},"required":true},"responses":{"200":{"description":"Developments at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DevelopmentFromDB"},"type":"array","title":"Response 200 Search Developments"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/search_developments.html"}},"/v0/search/retrieve_development":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Retrieve Development","description":"Retrieve a specific development by its ID.","operationId":"retrieve_development","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveDevelopmentParams"}}},"required":true},"responses":{"200":{"description":"Development at detail=full.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevelopmentFromDB"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/retrieve_development.html"}},"/v0/search/retrieve_event_developments":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Retrieve Event Developments","description":"Retrieve all developments associated with a known event_id. Filters for timestamp and occurrence are available. Track and understand the full event lifecycle through its developments.","operationId":"retrieve_event_developments","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveEventDevelopmentsParams"}}},"required":true},"responses":{"200":{"description":"Event with developments at detail=full.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventWithDevelopments"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/retrieve_event_developments.html"}},"/v0/search/search_events":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Search Events","description":"Search for events semantically (or not). Various filters available: timestamp, occurrence, event type, symbols, and more.","operationId":"search_events","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSearchParams"}}},"required":true},"responses":{"200":{"description":"Events at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EventFromDB"},"type":"array","title":"Response 200 Search Events"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/search_events.html"}},"/v0/search/list_wire":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"List Wire","description":"Return the most recent wire items that match the given filters.","operationId":"list_wire","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WireListParams"}}}},"responses":{"200":{"description":"Wire items at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WireItem"},"type":"array","title":"Response 200 List Wire"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/list_wire.html"}},"/v0/search/wire_storyline":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Wire Storyline","description":"Retrieve the novelty storyline for a wire item: the linear prior_wire_id ancestor chain plus first-degree branches (items that point at any ancestor).","operationId":"wire_storyline","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WireStorylineParams"}}},"required":true},"responses":{"200":{"description":"Wire storyline at detail=full.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WireStoryline"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/wire_storyline.html"}},"/v0/search/retrieve_entity":{"post":{"tags":["V0","Search","HAS_MCP_EQUIVALENT"],"summary":"Retrieve Entity","description":"Realtime context package for one entity.","operationId":"retrieve_entity","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrieveEntityParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityDataPackage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/retrieve_entity.html"}},"/v0/alert/create_alert":{"post":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Create Alert","description":"Create an alert that periodically polls an endpoint and delivers new results to your configured receivers (webhook, email, and/or telegram).","operationId":"create_alert","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertInstructions"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/create_alert.html"}},"/v0/alert/get_alerts":{"get":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Get Alerts","description":"Retrieve all alerts for the authenticated user, including recent attempt and delivery history.","operationId":"get_alerts","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AlertRecord"},"type":"array","title":"Response Get Alerts"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/get_alerts.html"}},"/v0/alert/deactivate_alert":{"post":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Deactivate Alert","description":"Deactivate an alert by setting its status to 'paused'.","operationId":"deactivate_alert","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertId"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"string","title":"Response Deactivate Alert"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/alert/activate_alert":{"post":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Activate Alert","description":"Activate an alert by setting its status to 'active'.","operationId":"activate_alert","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertId"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"string","title":"Response Activate Alert"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/alert/delete_alert":{"post":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Delete Alert","description":"Permanently delete an alert from the database.","operationId":"delete_alert","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertId"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"string","title":"Response Delete Alert"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/alert/execute_alert":{"post":{"tags":["V0","Alert","HAS_MCP_EQUIVALENT"],"summary":"Execute Alert","description":"Execute an alert immediately to test it. Runs the exact same path as scheduled execution, including history and dedup.","operationId":"execute_alert","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertId"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"string","title":"Response Execute Alert"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/signal/market":{"post":{"tags":["V0","Signal","HAS_MCP_EQUIVALENT"],"summary":"Market Signal","description":"Per-bar wire attention (count) and net-sum entity sentiment (sum, std) for one sector, country, or asset class. Max 60d history.","operationId":"market_signal","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketSignalParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketSignalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v0/filings/list_guidance":{"post":{"tags":["V0","Filings","HAS_MCP_EQUIVALENT"],"summary":"List Guidance","description":"Forward-looking guidance issued by public companies, grouped into series with revision history.","operationId":"list_guidance","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceListParams"}}}},"responses":{"200":{"description":"Guidance series at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GuidanceSeries"},"type":"array","title":"Response 200 List Guidance"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/list_guidance.html"}},"/v0/filings/list_guidance_outcomes":{"post":{"tags":["V0","Filings","HAS_MCP_EQUIVALENT"],"summary":"List Guidance Outcomes","description":"Company guidance versus the reported actual.","operationId":"list_guidance_outcomes","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceOutcomeListParams"}}}},"responses":{"200":{"description":"Guidance outcomes at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GuidanceOutcome"},"type":"array","title":"Response 200 List Guidance Outcomes"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/list_guidance_outcomes.html"}},"/v0/filings/list_changes":{"post":{"tags":["V0","Filings","HAS_MCP_EQUIVALENT"],"summary":"List Changes","description":"Qualitative wording changes between consecutive earnings press releases: what the filer started saying, stopped saying, or now says differently.","operationId":"list_changes","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeListParams"}}}},"responses":{"200":{"description":"Disclosure changes at detail=full.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DisclosureChange"},"type":"array","title":"Response 200 List Changes"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/list_changes.html"}},"/v0/filings/guidance_bias":{"post":{"tags":["V0","Filings","HAS_MCP_EQUIVALENT"],"summary":"Guidance Bias","description":"Aggregate score of company guidance versus reported actuals. One point per report period.","operationId":"guidance_bias","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidanceBiasParams"}}},"required":true},"responses":{"200":{"description":"Guidance-bias time series.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GuidanceBias"},"type":"array","title":"Response 200 Guidance Bias"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"x-mcp-ui":"ui://ultralayer/guidance_bias.html"}},"/source/{source_table}/{source_id}/{access_key}":{"get":{"tags":["Source"],"summary":"Retrieve Source","description":"Return archived source content by table, id, and access key. Always includes source_timestamp and context; other keys are table-specific.","operationId":"retrieve_source","parameters":[{"name":"source_table","in":"path","required":true,"schema":{"type":"string","title":"Source Table"}},{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","title":"Source Id"}},{"name":"access_key","in":"path","required":true,"schema":{"type":"string","title":"Access Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AlertAttempt":{"properties":{"end_timestamp":{"type":"string","format":"date-time","title":"End Timestamp","description":"End of the query window used (== the start the next run dedups against)."},"execution_finished_at":{"type":"string","format":"date-time","title":"Execution Finished At","description":"When this execution finished."},"outcome":{"type":"string","enum":["no_data","below_threshold","endpoint_error","delivered","delivery_partial","delivery_failed"],"title":"Outcome","description":"Terminal state of this execution."},"item_count":{"type":"integer","title":"Item Count","description":"Items found in the window (0 on no_data / endpoint_error)."}},"type":"object","required":["end_timestamp","execution_finished_at","outcome","item_count"],"title":"AlertAttempt","description":"Cheap, always-written record of one execution: 'we ran the alert and this is what happened'. Carries no payload\nand no per-receiver results (those live only on deliveries)."},"AlertDelivery":{"properties":{"end_timestamp":{"type":"string","format":"date-time","title":"End Timestamp","description":"End of the query window used."},"delivered_at":{"type":"string","format":"date-time","title":"Delivered At","description":"Latest successful per-receiver delivery time."},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"The envelope that was delivered ({name, response})."},"receiver_results":{"items":{"$ref":"#/components/schemas/ReceiverResult"},"type":"array","title":"Receiver Results","description":"Per-receiver delivery outcomes."}},"type":"object","required":["end_timestamp","delivered_at","payload","receiver_results"],"title":"AlertDelivery","description":"Record of an execution that delivered to at least one receiver. Includes the payload that was sent."},"AlertId":{"properties":{"alert_id":{"type":"integer","title":"Alert Id"}},"additionalProperties":false,"type":"object","required":["alert_id"],"title":"AlertId"},"AlertInstructions":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name","description":"Unique label; auto-generated if omitted","examples":["apple_wire_sentiment"]},"path":{"type":"string","enum":["/v0/search/list_wire","/v0/search/semantic_search","/v0/search/search_developments","/v0/search/retrieve_event_developments","/v0/search/search_events","/v0/filings/list_guidance","/v0/filings/list_changes","/v0/filings/list_guidance_outcomes"],"title":"Path","description":"Endpoint the alert polls.","examples":["/v0/search/list_wire"]},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"Endpoint arguments, dont provide system timestamps.","examples":[{"entities":["Apple Inc."],"max_entity_sentiment":-0.3,"min_entity_sentiment":0.3,"novelty":["new","update","correction"]}]},"interval_minutes":{"type":"integer","maximum":43200.0,"minimum":5.0,"title":"Interval Minutes","description":"Poll interval; multiple of 5.","examples":[15]},"lookback_minutes":{"anyOf":[{"type":"integer","maximum":43200.0,"minimum":5.0},{"type":"null"}],"title":"Lookback Minutes","description":"Defaults to interval_minutes"},"threshold":{"type":"integer","minimum":1.0,"title":"Threshold","description":"Items required to fire.","default":1},"receivers":{"items":{"oneOf":[{"$ref":"#/components/schemas/WebhookReceiver"},{"$ref":"#/components/schemas/EmailReceiver"},{"$ref":"#/components/schemas/TelegramReceiver"}],"discriminator":{"propertyName":"type","mapping":{"email":"#/components/schemas/EmailReceiver","telegram":"#/components/schemas/TelegramReceiver","webhook":"#/components/schemas/WebhookReceiver"}}},"type":"array","maxItems":2,"minItems":1,"title":"Receivers","description":"1-2 unique targets."}},"additionalProperties":false,"type":"object","required":["path","arguments","interval_minutes","receivers"],"title":"AlertInstructions"},"AlertRecord":{"properties":{"alert_id":{"type":"integer","title":"Alert Id","description":"Unique identifier for the alert."},"name":{"type":"string","title":"Name","description":"Human label for the alert."},"status":{"type":"string","enum":["active","paused"],"title":"Status","description":"Current status of the alert."},"path":{"type":"string","enum":["/v0/search/list_wire","/v0/search/semantic_search","/v0/search/search_developments","/v0/search/retrieve_event_developments","/v0/search/search_events","/v0/filings/list_guidance","/v0/filings/list_changes","/v0/filings/list_guidance_outcomes"],"title":"Path","description":"The endpoint the alert polls."},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"The endpoint arguments."},"interval_minutes":{"type":"integer","maximum":43200.0,"minimum":5.0,"title":"Interval Minutes","description":"How often the alert checks the endpoint, in minutes."},"lookback_minutes":{"type":"integer","maximum":43200.0,"minimum":5.0,"title":"Lookback Minutes","description":"Rolling lookback window, in minutes."},"threshold":{"type":"integer","title":"Threshold","description":"Minimum item count before the alert fires."},"receivers":{"items":{"oneOf":[{"$ref":"#/components/schemas/WebhookReceiver"},{"$ref":"#/components/schemas/EmailReceiver"},{"$ref":"#/components/schemas/TelegramReceiver"}],"discriminator":{"propertyName":"type","mapping":{"email":"#/components/schemas/EmailReceiver","telegram":"#/components/schemas/TelegramReceiver","webhook":"#/components/schemas/WebhookReceiver"}}},"type":"array","title":"Receivers","description":"The configured delivery targets."},"last_triggered_end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Triggered End Timestamp","description":"end_timestamp of the last successful delivery, or null."},"attempts":{"items":{"$ref":"#/components/schemas/AlertAttempt"},"type":"array","title":"Attempts","description":"Recent execution attempts (no payload)."},"deliveries":{"items":{"$ref":"#/components/schemas/AlertDelivery"},"type":"array","title":"Deliveries","description":"Recent deliveries (includes payload)."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the alert was created."}},"type":"object","required":["alert_id","name","status","path","arguments","interval_minutes","lookback_minutes","threshold","receivers","last_triggered_end_timestamp","attempts","deliveries","created_at"],"title":"AlertRecord"},"ChangeListParams":{"properties":{"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":10},"symbols":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Symbols","description":"Match any.","examples":[["NVDA","AAPL"]]},"change_kinds":{"anyOf":[{"items":{"type":"string","enum":["added","removed","modified"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Change Kinds","description":"Match any."},"change_categories":{"anyOf":[{"items":{"type":"string","enum":["metric_definition","disclosed_metric","accounting_policy","reporting_structure","guidance_basis","results_attribution","risk","catalyst","legal","policy","discrete_item","capital_action","strategy","business_description","product","supply_chain","property_and_equipment","concentration","governance","compensation","control_and_audit"]},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Change Categories","description":"Match any."},"impact":{"anyOf":[{"items":{"type":"string","enum":["positive","negative","neutral"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Impact","description":"Match any."},"min_materiality_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Min Materiality Score","description":"0-.2 reword; .2-.4 weak; .4-.6 mod; .6-.8 high; .8-1 must-read","default":0.4},"fiscal_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1990.0},{"type":"null"}],"title":"Fiscal Year"},"fiscal_quarter":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Fiscal Quarter"},"sort":{"type":"string","enum":["timestamp","materiality"],"title":"Sort","description":"timestamp: newest first; materiality: highest materiality_score first.","default":"timestamp"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:finding; standard:citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","title":"ChangeListParams"},"DevelopmentFromDB":{"properties":{"development_id":{"type":"integer","title":"Development Id","description":"Logical identifier for the development across updates."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Canonical backtest system timestamp of this development version."},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"Most recent timestamp of any source used for the development."},"occurrence_timestamp":{"type":"string","format":"date-time","title":"Occurrence Timestamp","description":"Actual (estimate of) real world time that the development took place."},"occurrence_timestamp_confidence_score":{"type":"number","title":"Occurrence Timestamp Confidence Score","description":"Confidence score in estimate of occurrence_timestamp."},"name":{"type":"string","title":"Name","description":"Name of the development."},"description":{"type":"string","title":"Description","description":"Description of the development."},"development_type":{"type":"string","title":"Development Type","description":"Type of the development."},"occurrence_status":{"type":"string","title":"Occurrence Status","description":"Status of the real world occurrence."},"rationale":{"type":"string","title":"Rationale","description":"Explanation for all decisions made."},"stakeholders":{"items":{"$ref":"#/components/schemas/StakeholderImpact"},"type":"array","title":"Stakeholders","description":"List of involved stakeholders and their impacts."},"importance_score":{"type":"number","title":"Importance Score","description":"LLM heuristic of general development importance."},"surprise_score":{"type":"number","title":"Surprise Score","description":"LLM heuristic of how surprising the development is to the market."},"confidence_score":{"type":"number","title":"Confidence Score","description":"LLM heuristic of its confidence in everything it presents."},"events":{"items":{"$ref":"#/components/schemas/EventSummary"},"type":"array","title":"Events","description":"List of events this development is associated with, resolved to their most recent known state."},"sources":{"items":{"$ref":"#/components/schemas/SourceWithQuotes"},"type":"array","title":"Sources","description":"List of sources used for this development."}},"type":"object","required":["development_id","timestamp","source_timestamp","occurrence_timestamp","occurrence_timestamp_confidence_score","name","description","development_type","occurrence_status","rationale","stakeholders","importance_score","surprise_score","confidence_score","events","sources"],"title":"DevelopmentFromDB","description":"A development as returned from the database.\nAlways represents the latest known version of the development at or before the requested end_timestamp."},"DevelopmentSearchParams":{"properties":{"query":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Query","examples":["Semiconductor supply chain disruptions"]},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"start_occurrence_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Occurrence Timestamp","description":"Real-world occurrence timestamp; Inclusive ISO 8601"},"end_occurrence_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Occurrence Timestamp","description":"Real-world occurrence timestamp; Inclusive ISO 8601"},"development_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Development Type","examples":["corporate_action"]},"symbols":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Symbols","description":"Match any.","examples":[["NVDA","AAPL"]]},"min_impact_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Min Impact Score","description":"+-.5+ strong; 0..+-.5 weak; 0 neutral; both: >=min OR <=max"},"max_impact_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Max Impact Score"},"min_importance_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Importance Score","description":"0-.2 noise; .2-.4 minor; .4-.6 expected/mod; .6-.8 material; .8-1 critical"},"min_surprise_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Surprise Score","description":"0-.2 known; .2-.4 expected; .4-.6 modest; .6-.8 notable; .8-1 shock"},"min_confidence_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Confidence Score","description":"<.2 unreliable; .4-.6 incomplete; .6+ strong; .8+ explicit"},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:scored+citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","title":"DevelopmentSearchParams"},"DevelopmentSummary":{"properties":{"development_id":{"type":"integer","title":"Development Id","description":"Logical identifier for the development across updates."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Canonical backtest system timestamp of this development version."},"occurrence_timestamp":{"type":"string","format":"date-time","title":"Occurrence Timestamp","description":"Actual (estimate of) real world time that the development took place."},"occurrence_timestamp_confidence_score":{"type":"number","title":"Occurrence Timestamp Confidence Score","description":"Confidence score in estimate of occurrence_timestamp."},"name":{"type":"string","title":"Name","description":"Name of the development."},"description":{"type":"string","title":"Description","description":"Description of the development."},"development_type":{"type":"string","title":"Development Type","description":"Type of the development."},"occurrence_status":{"type":"string","title":"Occurrence Status","description":"Status of the real world occurrence."},"importance_score":{"type":"number","title":"Importance Score","description":"LLM heuristic of general development importance."},"surprise_score":{"type":"number","title":"Surprise Score","description":"LLM heuristic of how surprising the development is to the market."},"confidence_score":{"type":"number","title":"Confidence Score","description":"LLM heuristic of its confidence in everything it presents."},"event_ids":{"items":{"type":"integer"},"type":"array","title":"Event Ids","description":"Raw list of event IDs this development is associated with."}},"type":"object","required":["development_id","timestamp","occurrence_timestamp","occurrence_timestamp_confidence_score","name","description","development_type","occurrence_status","importance_score","surprise_score","confidence_score","event_ids"],"title":"DevelopmentSummary","description":"Lightweight development summary embedded within an EventFromDB response.\nOmits heavy fields (rationale, stakeholders, sources) that are not strictly needed\nto understand what a development is in the context of scanning events."},"DisclosureChange":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Filer name."},"cik":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cik","description":"SEC CIK of the filer."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"System timestamp of this change."},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"When the current release became public."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Filer fiscal year of the current release's completed period."},"fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Quarter","description":"Filer fiscal quarter of the current release; null for a full-year report."},"prior_fiscal_year":{"type":"integer","title":"Prior Fiscal Year","description":"Filer fiscal year of the prior release's completed period."},"prior_fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prior Fiscal Quarter","description":"Filer fiscal quarter of the prior release; null for a full-year report."},"change_kind":{"type":"string","enum":["added","removed","modified"],"title":"Change Kind","description":"added, removed, or modified."},"change_category":{"type":"string","title":"Change Category","description":"Kind of disclosure that changed."},"summary":{"type":"string","title":"Summary","description":"One sentence stating what changed."},"current_quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Quote","description":"Evidencing sentence in the current release. Null on a removal."},"prior_quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Quote","description":"Evidencing sentence in the prior release. Null on an addition."},"materiality_score":{"type":"number","title":"Materiality Score","description":"0-.2 reword; .2-.4 weak; .4-.6 mod; .6-.8 high; .8-1 must-read"},"impact":{"type":"string","enum":["positive","negative","neutral"],"title":"Impact","description":"Which way the change moves a reader's view of the company."},"current_source":{"$ref":"#/components/schemas/Source","description":"Current release."},"prior_source":{"$ref":"#/components/schemas/Source","description":"Prior release."}},"type":"object","required":["symbol","company_name","cik","timestamp","source_timestamp","fiscal_year","fiscal_quarter","prior_fiscal_year","prior_fiscal_quarter","change_kind","change_category","summary","current_quote","prior_quote","materiality_score","impact","current_source","prior_source"],"title":"DisclosureChange","description":"One evidenced qualitative change between consecutive earnings releases."},"EmailReceiver":{"properties":{"type":{"type":"string","const":"email","title":"Type"}},"additionalProperties":false,"type":"object","required":["type"],"title":"EmailReceiver"},"EntityCoMention":{"properties":{"entity_id":{"type":"integer","title":"Entity Id","description":"Entity id of the co-mentioned entity."},"canonical_name":{"type":"string","title":"Canonical Name","description":"Entity name of the co-mentioned entity."},"share":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Share","description":"Fraction of the co-mention sample wire items that also mention this entity at primary or significant relevance."}},"type":"object","required":["entity_id","canonical_name","share"],"title":"EntityCoMention","description":"Entity frequently co-mentioned with the target on recent high-relevance wire items."},"EntityDataPackage":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Canonical system timestamp when this package was assembled."},"entity":{"$ref":"#/components/schemas/EntitySummary"},"recent_wire_items":{"items":{"$ref":"#/components/schemas/EntityRecentWireItem"},"type":"array","title":"Recent Wire Items","description":"Most recent non-duplicate wire items where this entity is primary or significant."},"sentiment_chart":{"items":{"$ref":"#/components/schemas/EntitySentimentBar"},"type":"array","title":"Sentiment Chart","description":"Calendar-day bars (oldest first). Empty days are null, not omitted."},"co_mentions":{"items":{"$ref":"#/components/schemas/EntityCoMention"},"type":"array","title":"Co Mentions","description":"Top co-mentioned entities from a bounded recent sample of primary/significant wire items."}},"type":"object","required":["timestamp","entity","recent_wire_items","sentiment_chart","co_mentions"],"title":"EntityDataPackage","description":"Realtime context package for one Ultralayer entity."},"EntityRecentWireItem":{"properties":{"wire_id":{"type":"integer","title":"Wire Id"},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp"},"headline":{"type":"string","title":"Headline","description":"Wire headline."},"novelty":{"type":"string","enum":["new","update","correction"],"title":"Novelty","description":"Novelty label."},"relevance":{"type":"string","enum":["primary","significant"],"title":"Relevance","description":"Entity relevance."}},"type":"object","required":["wire_id","source_timestamp","headline","novelty","relevance"],"title":"EntityRecentWireItem","description":"Recent wire item where this entity is primary or significant."},"EntitySentimentBar":{"properties":{"end_timestamp":{"type":"string","format":"date-time","title":"End Timestamp","description":"Exclusive end of this UTC calendar-day bar."},"weighted_sentiment":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Weighted Sentiment","description":"Relevance-weighted average sentiment in [-1, 1] for the day. Null when there were no observations."},"weighted_std":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weighted Std","description":"Relevance-weighted standard deviation of sentiment for the day. Null when there were no observations."},"mention_count":{"type":"integer","minimum":0.0,"title":"Mention Count","description":"Number of wire items contributing to this bar."}},"type":"object","required":["end_timestamp","weighted_sentiment","weighted_std","mention_count"],"title":"EntitySentimentBar","description":"One UTC calendar-day bar of relevance-weighted entity sentiment."},"EntitySummary":{"properties":{"entity_id":{"type":"integer","title":"Entity Id","description":"Root entity id."},"canonical_name":{"type":"string","title":"Canonical Name","description":"Root entity name."},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},"type":"object","required":["entity_id","canonical_name","entity_type"],"title":"EntitySummary","description":"Resolved entity identity."},"EventFromDB":{"properties":{"event_id":{"type":"integer","title":"Event Id","description":"Logical identifier for the event."},"name":{"type":"string","title":"Name","description":"Name of the event."},"description":{"type":"string","title":"Description","description":"Description of the event."},"event_type":{"type":"string","title":"Event Type","description":"Type of the event."},"recent_developments":{"items":{"$ref":"#/components/schemas/DevelopmentSummary"},"type":"array","title":"Recent Developments","description":"Most recent developments for this event (count controlled by developments_per_event param), ordered by occurrence_timestamp descending."}},"type":"object","required":["event_id","name","description","event_type","recent_developments"],"title":"EventFromDB","description":"Response model for search_events.\nEach event includes a condensed list of its most recent developments for quick scanning.\nFull developments can be retrieved via retrieve_event_developments."},"EventSearchParams":{"properties":{"query":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Query","examples":["High Bandwidth Memory"]},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type","examples":["legal_proceeding"]},"symbols":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Symbols","description":"Match any.","examples":[["NVDA","AAPL"]]},"limit":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Limit","default":5},"developments_per_event":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Developments Per Event","default":3},"include_future_developments":{"type":"boolean","title":"Include Future Developments","description":"Include future occurrence times relative to end_timestamp or now.","default":true},"detail":{"type":"string","enum":["full","essential"],"title":"Detail","description":"essential:minimal; full:all.","default":"full"}},"additionalProperties":false,"type":"object","title":"EventSearchParams"},"EventSummary":{"properties":{"event_id":{"type":"integer","title":"Event Id","description":"Logical identifier for the event across updates."},"name":{"type":"string","title":"Name","description":"Name of the event."},"description":{"type":"string","title":"Description","description":"Description of the event."},"event_type":{"type":"string","title":"Event Type","description":"Type of the event."}},"type":"object","required":["event_id","name","description","event_type"],"title":"EventSummary","description":"Lightweight event summary embedded within a DevelopmentFromDB response.\nProvides enough context for the user to understand what event a development belongs to\nwithout requiring a separate event lookup."},"EventWithDevelopments":{"properties":{"event_id":{"type":"integer","title":"Event Id","description":"Logical identifier for the event."},"name":{"type":"string","title":"Name","description":"Name of the event."},"description":{"type":"string","title":"Description","description":"Description of the event."},"event_type":{"type":"string","title":"Event Type","description":"Type of the event."},"developments":{"items":{"$ref":"#/components/schemas/DevelopmentFromDB"},"type":"array","title":"Developments","description":"Developments associated with this event, ordered by occurrence_timestamp descending (real-world timeline)."}},"type":"object","required":["event_id","name","description","event_type","developments"],"title":"EventWithDevelopments","description":"Response model for retrieve_event_developments.\nWraps full event details with its associated developments."},"Factor":{"properties":{"name":{"type":"string","title":"Name","description":"Unique snake_case mechanism label. Compressed so it is decision-useful alone; reusable across similar situations."},"description":{"type":"string","title":"Description","description":"Self-contained definition of what the factor represents."},"factor_scale":{"type":"string","enum":["BINARY","CATEGORICAL","CONTINUOUS","SIGNED_CONTINUOUS"],"title":"Factor Scale","description":"Scale of factor."},"rubric":{"type":"string","title":"Rubric","description":"Short operational scoring rubric with observable criteria to ensure global consistency when reused."},"allowed_values":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Values","description":"Only for CATEGORICAL: enum of allowed category strings."}},"type":"object","required":["name","description","factor_scale","rubric"],"title":"Factor","description":"Dimension for differentiating stakeholders as they relate to the situation"},"FactorAssessment":{"properties":{"rationale":{"type":"string","title":"Rationale","description":"Self-contained brief explanation of the assessment for this stakeholder on this factor."},"value":{"anyOf":[{"type":"boolean"},{"type":"number"},{"type":"string"}],"title":"Value","description":"Assessed value (type depends on factor_type). 1. BINARY -> bool; 2. CONTINUOUS -> float in [0,1]; 3. SIGNED_CONTINUOUS -> float in [-1,1]; 4. CATEGORICAL -> str in allowed_values."},"sources_with_quotes":{"items":{"$ref":"#/components/schemas/SourceWithQuotes"},"type":"array","minItems":1,"title":"Sources With Quotes","description":"List of sources (with exact quotes) that support this factor assessment."}},"type":"object","required":["rationale","value","sources_with_quotes"],"title":"FactorAssessment","description":"Factor assessment information with relevant sources"},"FactorMatrixRow":{"properties":{"factor":{"$ref":"#/components/schemas/Factor","description":"Factor definition."},"stakeholder_assessments":{"additionalProperties":{"$ref":"#/components/schemas/FactorAssessment"},"type":"object","title":"Stakeholder Assessments","description":"Map: stakeholder symbol -> assessment object for this factor."}},"type":"object","required":["factor","stakeholder_assessments"],"title":"FactorMatrixRow","description":"A row in the factor matrix, containing assessments for the stakeholders this factor applies to."},"FeedsSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"Feed entry title."},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Internal publisher/feed key when known."}},"type":"object","required":["title","publisher"],"title":"FeedsSourceMetadata","description":"source_metadata for rows where source_table == \"feeds\".\n\nRSS headline rows. publisher is the internal feed/publisher key (nullable when unknown)."},"FilingDocumentSourceMetadata":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Year","description":"Filer fiscal year of the completed period this document reports, when it reports one."},"fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Quarter","description":"Filer fiscal quarter of that completed period; null for a full-year report or a document that reports no completed period."},"document_type":{"type":"string","title":"Document Type","description":"Source-native document label, e.g. EX-99.1 or transcript."}},"type":"object","required":["symbol","fiscal_year","fiscal_quarter","document_type"],"title":"FilingDocumentSourceMetadata","description":"source_metadata for rows where source_table == \"fi_documents\".\n\nNo title column on fi_documents — do not invent one. document_class is not here: it is\nalready GuidanceValue.source_type. fiscal_year / fiscal_quarter are the document's\ncompleted report period, not the guided period on the series — a Q2 release guiding FY\nrevenue has Q2 here and FY on the series. Filing: fi_filings (nullable on a guidance\nupdate or an annual quarter). Call: fi_earnings_calls (always both; Q4 is 4). url lives\non Source, not here: filing exhibits keep the document url; transcripts have none and\nSource mints a capability URL (ultralayer_python.source_url)."},"FmpCompanySourceMetadata":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing ticker of the company."},"company_name":{"type":"string","title":"Company Name","description":"Company name."}},"type":"object","required":["symbol","company_name"],"title":"FmpCompanySourceMetadata","description":"source_metadata for FMP data about one company. Today: rows where source_table == \"fmp_company_descriptions\".\n\nLightweight identifiers only; the cited content is retrieved via source_id.\nSource.coerce_source_metadata_and_url mints FMP's page for symbol onto Source.url\n(ultralayer_python.source_url.build_fmp_company_url) for any table registered with this model. Nothing is stored for it.\nAnother FMP company table reuses it by registering in SOURCE_METADATA_BY_TABLE and widening Source.source_table."},"GuidanceBias":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Filer name."},"cik":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cik","description":"SEC CIK of the filer."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"System timestamp of the latest actual in this period."},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"When the latest actual in this period became public."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Filer fiscal year of the report that printed the actual."},"fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Quarter","description":"Filer fiscal quarter of that report; null for a full-year report."},"bias_score":{"type":"number","title":"Bias Score","description":"Mean of mapped labels: significantly_exceeded=2, exceeded=1, in_line=0, missed=-1, significantly_missed=-2."},"resolved_count":{"type":"integer","title":"Resolved Count","description":"Resolved outcomes in the mean."},"label_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Label Counts","description":"Resolved label counts in the mean."}},"type":"object","required":["symbol","company_name","cik","timestamp","source_timestamp","fiscal_year","fiscal_quarter","bias_score","resolved_count","label_counts"],"title":"GuidanceBias","description":"Aggregate score of company guidance versus reported actuals for one report period."},"GuidanceBiasParams":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"}},"additionalProperties":false,"type":"object","required":["symbol"],"title":"GuidanceBiasParams"},"GuidanceListParams":{"properties":{"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":10},"symbols":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Symbols","description":"Match any.","examples":[["NVDA","AAPL"]]},"metric_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Metric Keys","description":"Match any.","examples":[["revenue"]]},"metric_key_exact_match":{"type":"boolean","title":"Metric Key Exact Match","description":"true: exact metric_keys, case-insensitive; false: case-insensitive substring. Ignored without metric_keys.","default":false},"metric_basis":{"anyOf":[{"items":{"type":"string","enum":["gaap","non_gaap","unspecified"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Metric Basis","description":"Match any."},"segments":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Segments","description":"Match any. 'null' is consolidated.","examples":[["null"],["AWS"]]},"guided_period_type":{"anyOf":[{"items":{"type":"string","enum":["quarter","fiscal_year","half","multi_year","other"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Guided Period Type","description":"Match any."},"guided_fiscal_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1990.0},{"type":"null"}],"title":"Guided Fiscal Year"},"guided_fiscal_quarter":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Guided Fiscal Quarter"},"guided_period_end_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End From","description":"Inclusive guided period-end date."},"guided_period_end_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End To","description":"Inclusive guided period-end date."},"source_types":{"anyOf":[{"items":{"type":"string","enum":["earnings_release","guidance_update","interim_update","earnings_call"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Source Types","description":"Match any. Document class the observation was read from.","examples":[["earnings_release"]]},"revision_direction":{"anyOf":[{"items":{"type":"string","enum":["new","raised","lowered","maintained","withdrawn"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Revision Direction","description":"Match any; latest observation only."},"sort":{"type":"string","enum":["timestamp","guided_period_end","comparable","revision_delta"],"title":"Sort","description":"timestamp: recently updated; guided_period_end: period date; comparable: strongest like-for-like number in the match set; revision_delta: largest midpoint move.","default":"timestamp"},"values_mode":{"type":"string","enum":["all","latest"],"title":"Values Mode","description":"all: revision history, newest first; latest: newest observation only.","default":"all"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:quotes; standard:citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","title":"GuidanceListParams"},"GuidanceOutcome":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Filer name."},"cik":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cik","description":"SEC CIK of the filer."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"System timestamp of the outcome."},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"When the actual became public."},"metric_key":{"type":"string","title":"Metric Key","description":"Normalized metric identity."},"metric_basis":{"type":"string","enum":["gaap","non_gaap","unspecified"],"title":"Metric Basis","description":"gaap, non_gaap, or unspecified."},"segment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Segment","description":"Segment cut; null for consolidated guidance."},"guided_period_type":{"type":"string","enum":["quarter","fiscal_year","half","multi_year","other"],"title":"Guided Period Type","description":"Kind of period being guided."},"guided_fiscal_year":{"type":"integer","title":"Guided Fiscal Year","description":"Filer fiscal year of the guided period."},"guided_fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Guided Fiscal Quarter","description":"Filer fiscal quarter of the guided period; null for a full year."},"guided_period_end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End Date","description":"Calendar day the guided period ends."},"guidance_source_type":{"type":"string","title":"Guidance Source Type","description":"Document class the scored guide was issued from."},"actual_source_type":{"type":"string","title":"Actual Source Type","description":"Document class the actual was reported in."},"outcome":{"type":"string","enum":["significantly_exceeded","exceeded","in_line","missed","significantly_missed","indeterminate"],"title":"Outcome","description":"Judgment of the actual against the guide."},"rationale":{"type":"string","title":"Rationale","description":"Why this outcome label."},"guidance_quote":{"type":"string","title":"Guidance Quote","description":"Stating sentence of the scored guide."},"actual_quote":{"type":"string","title":"Actual Quote","description":"Sentence or table row the actual was read from."},"value_type":{"type":"string","enum":["range","point","floor","ceiling","approximate","qualitative"],"title":"Value Type","description":"Shape of the stated guide."},"value_form":{"type":"string","enum":["absolute","relative"],"title":"Value Form","description":"absolute is a level; relative is a change vs a temporal base."},"value_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Low","description":"Lower bound of the scored guide as stated."},"value_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value High","description":"Upper bound of the scored guide as stated."},"value_midpoint":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Midpoint","description":"Midpoint of the scored guide as stated."},"unit":{"type":"string","enum":["currency","percent","basis_points","ratio","shares","count","other"],"title":"Unit","description":"Unit of the stated guide."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO currency code when unit is currency."},"actual_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Value","description":"Reported actual, scaled."},"actual_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actual Unit","description":"Unit of the reported actual."},"comparability":{"type":"string","enum":["comparable","not_comparable"],"title":"Comparability","description":"Whether the actual can be scored against the guide."},"vs_midpoint_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vs Midpoint Delta","description":"Actual minus guide midpoint, in the comparison unit."},"vs_midpoint_delta_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vs Midpoint Delta Pct","description":"Actual vs midpoint as a percent of the midpoint; 5.0 means 5% above."},"vs_low_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vs Low Delta","description":"Actual minus guide low bound."},"vs_high_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vs High Delta","description":"Actual minus guide high bound."},"guidance_source":{"$ref":"#/components/schemas/Source","description":"Document the scored guide was issued from."},"actual_source":{"$ref":"#/components/schemas/Source","description":"Document the actual was reported in."}},"type":"object","required":["symbol","company_name","cik","timestamp","source_timestamp","metric_key","metric_basis","segment","guided_period_type","guided_fiscal_year","guided_fiscal_quarter","guided_period_end_date","guidance_source_type","actual_source_type","outcome","rationale","guidance_quote","actual_quote","value_type","value_form","value_low","value_high","value_midpoint","unit","currency","actual_value","actual_unit","comparability","vs_midpoint_delta","vs_midpoint_delta_pct","vs_low_delta","vs_high_delta","guidance_source","actual_source"],"title":"GuidanceOutcome","description":"Company guidance versus the reported actual."},"GuidanceOutcomeListParams":{"properties":{"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":10},"symbols":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Symbols","description":"Match any.","examples":[["NVDA","AAPL"]]},"metric_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Metric Keys","description":"Match any.","examples":[["revenue"]]},"metric_key_exact_match":{"type":"boolean","title":"Metric Key Exact Match","description":"true: exact metric_keys, case-insensitive; false: case-insensitive substring. Ignored without metric_keys.","default":false},"metric_basis":{"anyOf":[{"items":{"type":"string","enum":["gaap","non_gaap","unspecified"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Metric Basis","description":"Match any."},"segments":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Segments","description":"Match any. 'null' is consolidated.","examples":[["null"],["AWS"]]},"guided_period_type":{"anyOf":[{"items":{"type":"string","enum":["quarter","fiscal_year","half","multi_year","other"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Guided Period Type","description":"Match any."},"guided_fiscal_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1990.0},{"type":"null"}],"title":"Guided Fiscal Year"},"guided_fiscal_quarter":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Guided Fiscal Quarter"},"guided_period_end_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End From","description":"Inclusive guided period-end date."},"guided_period_end_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End To","description":"Inclusive guided period-end date."},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:identity; standard:citable; full:all.","default":"full"},"outcomes":{"anyOf":[{"items":{"type":"string","enum":["significantly_exceeded","exceeded","in_line","missed","significantly_missed","indeterminate"]},"type":"array","maxItems":6,"minItems":1},{"type":"null"}],"title":"Outcomes","description":"Match any. Omit: resolved labels only."},"sort":{"type":"string","enum":["timestamp","outcome_abs"],"title":"Sort","description":"timestamp: newest actual first; outcome_abs: largest |score| first.","default":"timestamp"}},"additionalProperties":false,"type":"object","title":"GuidanceOutcomeListParams","description":"Request body for POST /v0/filings/list_guidance_outcomes."},"GuidanceSeries":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Listing symbol of the filer."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Filer name."},"cik":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cik","description":"SEC CIK of the filer."},"metric_key":{"type":"string","title":"Metric Key","description":"Normalized metric identity."},"metric_basis":{"type":"string","enum":["gaap","non_gaap","unspecified"],"title":"Metric Basis","description":"gaap, non_gaap, or unspecified."},"segment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Segment","description":"Segment cut; null for consolidated guidance."},"guided_period_type":{"type":"string","enum":["quarter","fiscal_year","half","multi_year","other"],"title":"Guided Period Type","description":"Kind of period being guided."},"guided_fiscal_year":{"type":"integer","title":"Guided Fiscal Year","description":"Filer fiscal year of the guided period."},"guided_fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Guided Fiscal Quarter","description":"Filer fiscal quarter of the guided period; null for a full year."},"guided_period_end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Guided Period End Date","description":"Calendar day the guided period ends."},"observation_count":{"type":"integer","title":"Observation Count","description":"Observations in this series as of the request end timestamp."},"values":{"items":{"$ref":"#/components/schemas/GuidanceValue"},"type":"array","title":"Values","description":"Point-in-time observations, newest first."}},"type":"object","required":["symbol","company_name","cik","metric_key","metric_basis","segment","guided_period_type","guided_fiscal_year","guided_fiscal_quarter","guided_period_end_date","observation_count","values"],"title":"GuidanceSeries","description":"One guided metric for one filer for one guided period, with its observation history."},"GuidanceValue":{"properties":{"quote":{"type":"string","title":"Quote","description":"Stating sentence from the source document."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"System timestamp of this observation."},"source_type":{"type":"string","title":"Source Type","description":"Document class this observation was read from."},"guidance_nature":{"type":"string","enum":["explicit","implied_in_text"],"title":"Guidance Nature","description":"explicit if stated directly; implied_in_text if inferred from wording."},"value_type":{"type":"string","enum":["range","point","floor","ceiling","approximate","qualitative"],"title":"Value Type","description":"Shape of the stated value."},"value_form":{"type":"string","enum":["absolute","relative"],"title":"Value Form","description":"absolute is a level; relative is a change vs a temporal base."},"value_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Low","description":"Lower bound as stated. Equal to value_high for a point."},"value_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value High","description":"Upper bound as stated."},"value_midpoint":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Midpoint","description":"Midpoint of the stated bounds. For a floor or ceiling, the stated bound."},"unit":{"type":"string","enum":["currency","percent","basis_points","ratio","shares","count","other"],"title":"Unit","description":"Unit of the stated value."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO currency code when unit is currency."},"qualitative_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qualitative Value","description":"Stated wording when value_type is qualitative."},"yoy_value_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yoy Value Low","description":"Year-over-year change, lower bound."},"yoy_value_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yoy Value High","description":"Year-over-year change, upper bound."},"yoy_value_midpoint":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yoy Value Midpoint","description":"Year-over-year change, midpoint. For a floor or ceiling, the stated YoY bound."},"yoy_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yoy Unit","description":"percent or basis_points."},"yoy_base_fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yoy Base Fiscal Year","description":"Fiscal year of the prior-year actual used for the year-over-year change."},"yoy_base_fiscal_quarter":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yoy Base Fiscal Quarter","description":"Fiscal quarter of that prior-year actual; null for a full-year guide."},"yoy_base_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yoy Base Value","description":"Prior-year actual level used to compute the year-over-year change."},"revision_direction":{"anyOf":[{"type":"string","enum":["new","raised","lowered","maintained","withdrawn"]},{"type":"null"}],"title":"Revision Direction","description":"Whether the outlook moved vs the prior observation."},"revision_range_change":{"anyOf":[{"type":"string","enum":["reaffirmed","narrowed","widened","shifted","not_comparable"]},{"type":"null"}],"title":"Revision Range Change","description":"How the stated range changed vs the prior observation."},"revision_midpoint_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revision Midpoint Delta","description":"New midpoint minus prior midpoint, in the stated unit."},"revision_midpoint_delta_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revision Midpoint Delta Pct","description":"Midpoint change as a percent of the absolute prior midpoint; 5.0 means raised 5%. Positive is an increase."},"source":{"$ref":"#/components/schemas/Source","description":"Document this observation was read from."}},"type":"object","required":["quote","timestamp","source_type","guidance_nature","value_type","value_form","value_low","value_high","value_midpoint","unit","currency","qualitative_value","yoy_value_low","yoy_value_high","yoy_value_midpoint","yoy_unit","yoy_base_fiscal_year","yoy_base_fiscal_quarter","yoy_base_value","revision_direction","revision_range_change","revision_midpoint_delta","revision_midpoint_delta_pct","source"],"title":"GuidanceValue","description":"One point-in-time observation of a guidance series."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MarketBar":{"properties":{"bar":{"type":"string","format":"date-time","title":"Bar","description":"Exclusive bucket end."},"count":{"type":"integer","title":"Count","description":"Wire items about the scope value."},"sentiment":{"type":"number","title":"Sentiment","description":"Net sum of entity mention sentiments (-1..1 each); 0 when empty or no mentions."},"sentiment_std":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sentiment Std","description":"Dispersion (population std) of those mention sentiments; null when no mentions."},"partial":{"type":"boolean","title":"Partial","description":"True on the in-progress bucket.","default":false}},"type":"object","required":["bar","count","sentiment","sentiment_std"],"title":"MarketBar","description":"One bucket of wire activity for a market scope value."},"MarketSignalParams":{"properties":{"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601; omitted=last 14 bars; max 60d"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"resolution":{"type":"string","pattern":"^([1-9]|[12][0-9]|30)d$","title":"Resolution","description":"Bucket length in UTC days; 1d-30d.","default":"1d"},"value":{"type":"string","title":"Value","description":"One sector, country (ISO 3166-1 alpha-2, lowercase), or asset class."},"novelty":{"items":{"type":"string","enum":["new","update","duplicate","correction"]},"type":"array","maxItems":4,"minItems":1,"title":"Novelty","description":"Match any.","default":["new","update","duplicate","correction"]}},"additionalProperties":false,"type":"object","required":["value"],"title":"MarketSignalParams"},"MarketSignalResponse":{"properties":{"signal":{"type":"string","title":"Signal","description":"Signal family."},"methodology_version":{"type":"integer","title":"Methodology Version","description":"Bumped when the signal definition changes."},"resolution":{"type":"string","title":"Resolution","description":"Bucket length used."},"bars":{"items":{"$ref":"#/components/schemas/MarketBar"},"type":"array","title":"Bars","description":"Oldest first; empty buckets included."}},"type":"object","required":["signal","methodology_version","resolution","bars"],"title":"MarketSignalResponse","description":"Contiguous market bar series."},"NewsSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"Title of the news article."},"publisher":{"type":"string","title":"Publisher","description":"Publisher of the news article."}},"type":"object","required":["title","publisher"],"title":"NewsSourceMetadata","description":"source_metadata for rows where source_table == \"news\".\n\nNews always has these two, so they are required (non-nullable). Do NOT widen this\nmodel for other sources; define a sibling model and register it in\nSOURCE_METADATA_BY_TABLE instead."},"PublisherSourceMetadataFilter":{"properties":{"key":{"type":"string","const":"publisher","title":"Key","default":"publisher"},"include_any":{"anyOf":[{"items":{"type":"string","enum":["finance.yahoo.com","www.globenewswire.com","seekingalpha.com","ca.finance.yahoo.com","thecurrencyanalytics.com","www.fxstreet.com","www.nasdaq.com","u.today","sg.finance.yahoo.com","investorplace.com","uk.finance.yahoo.com","dailyhodl.com","www.cnbc.com"]},"type":"array","minItems":1},{"type":"null"}],"title":"Include Any"},"exclude_any":{"anyOf":[{"items":{"type":"string","enum":["finance.yahoo.com","www.globenewswire.com","seekingalpha.com","ca.finance.yahoo.com","thecurrencyanalytics.com","www.fxstreet.com","www.nasdaq.com","u.today","sg.finance.yahoo.com","investorplace.com","uk.finance.yahoo.com","dailyhodl.com","www.cnbc.com"]},"type":"array","minItems":1},{"type":"null"}],"title":"Exclude Any"}},"type":"object","title":"PublisherSourceMetadataFilter"},"ReceiverResult":{"properties":{"type":{"type":"string","enum":["webhook","email","telegram"],"title":"Type","description":"The receiver channel."},"target":{"type":"string","title":"Target","description":"Where it was delivered (webhook url, telegram chat id, or account email)."},"status":{"type":"string","enum":["success","failed"],"title":"Status","description":"Whether delivery to this receiver succeeded."},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At","description":"When this receiver was successfully delivered to, or null on failure."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Failure reason, or null on success."}},"type":"object","required":["type","target","status"],"title":"ReceiverResult","description":"Outcome of delivering one envelope to one receiver. Embedded in a delivery record so partial failures\n(e.g. webhook ok, telegram down) stay visible."},"RetrieveDevelopmentParams":{"properties":{"development_id":{"type":"integer","title":"Development Id"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:scored+citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["development_id"],"title":"RetrieveDevelopmentParams"},"RetrieveEntityParams":{"properties":{"entity":{"type":"string","maxLength":200,"minLength":1,"title":"Entity","description":"Entity name","examples":["Apple Inc.","TSLA"]}},"additionalProperties":false,"type":"object","required":["entity"],"title":"RetrieveEntityParams"},"RetrieveEventDevelopmentsParams":{"properties":{"event_id":{"type":"integer","title":"Event Id"},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"include_future_developments":{"type":"boolean","title":"Include Future Developments","description":"Include future occurrence times relative to end_timestamp or now.","default":true},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:scored+citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["event_id"],"title":"RetrieveEventDevelopmentsParams"},"ScreenExposureType":{"properties":{"label":{"type":"string","title":"Label","description":"Short noun phrase a user would recognise, e.g. 'HBM memory supplier'."},"description":{"type":"string","title":"Description","description":"One sentence: which companies belong in this category."}},"type":"object","required":["label","description"],"title":"ScreenExposureType"},"ScreenParams":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query","examples":["US companies under $10bn that benefit from AI data centre power demand"]},"limit":{"type":"integer","maximum":40.0,"minimum":1.0,"title":"Limit","default":20},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:scored+citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["query"],"title":"ScreenParams"},"ScreenQuantFilter":{"properties":{"field":{"anyOf":[{"type":"string","enum":["country","sector","industry","exchange"]},{"type":"string","enum":["market_cap_basic","price_earnings_ttm","dividends_yield_current","total_revenue_yoy_growth_ttm","net_margin_ttm","Perf.1M","Perf.YTD","Perf.Y","Value.Traded","debt_to_equity"]}],"title":"Field"},"operation":{"type":"string","enum":["equal","greater","less","in_range"],"title":"Operation"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values","description":"Text field: accepted values. Numeric field: one number, two for in_range, plain digits."}},"type":"object","required":["field","operation","values"],"title":"ScreenQuantFilter"},"ScreenQuantSort":{"properties":{"field":{"type":"string","enum":["market_cap_basic","price_earnings_ttm","dividends_yield_current","total_revenue_yoy_growth_ttm","net_margin_ttm","Perf.1M","Perf.YTD","Perf.Y","Value.Traded","debt_to_equity"],"title":"Field","description":"market_cap_basic USD; price_earnings_ttm; dividends_yield_current %; total_revenue_yoy_growth_ttm %; net_margin_ttm %; Perf.1M, Perf.YTD, Perf.Y price change %; Value.Traded USD latest session; debt_to_equity ratio"},"order":{"type":"string","enum":["asc","desc"],"title":"Order"}},"type":"object","required":["field","order"],"title":"ScreenQuantSort"},"ScreenResponse":{"properties":{"criterion":{"type":"string","title":"Criterion","description":"The screening criterion restated as one precise sentence."},"score_rubric":{"type":"string","title":"Score Rubric","description":"What the exposure score means for this criterion."},"exposure_types":{"items":{"$ref":"#/components/schemas/ScreenExposureType"},"type":"array","title":"Exposure Types","description":"Categories the companies are grouped into."},"quant_filters":{"items":{"$ref":"#/components/schemas/ScreenQuantFilter"},"type":"array","title":"Quant Filters","description":"Quantitative filters applied before the exposure screen"},"quant_sort":{"anyOf":[{"$ref":"#/components/schemas/ScreenQuantSort"},{"type":"null"}],"description":"Sort of the quantitative scan; null when none ran"},"quant_filter_match_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quant Filter Match Count","description":"Companies that passed the quantitative filters; null when none ran"},"results":{"items":{"$ref":"#/components/schemas/ScreenResult"},"type":"array","title":"Results","description":"Companies that meet the criterion, strongest exposure first."}},"type":"object","required":["criterion","score_rubric","exposure_types","results"],"title":"ScreenResponse","description":"Public response. Carries the rubric and categories so a user can see what a score means and how the table is grouped."},"ScreenResult":{"properties":{"stakeholder":{"$ref":"#/components/schemas/StakeholderBase","description":"The company."},"exposure_score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Exposure Score","description":"Sign: + benefits, - hurt as the criterion strengthens. Size: .5+ strong; below .5 weak."},"exposure_type":{"type":"string","title":"Exposure Type","description":"Short label for how the company is tied to the criterion. Shared by companies tied the same way."},"rationale":{"type":"string","title":"Rationale","description":"One or two self-contained sentences stating how the company is tied to the criterion."},"sources_with_quotes":{"items":{"$ref":"#/components/schemas/SourceWithQuotes"},"type":"array","minItems":1,"title":"Sources With Quotes","description":"Sources (with exact quotes) that support this result."},"market_data":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Market Data","description":"Listing data (country, sector, industry, market cap USD, valuation, growth, margin, price change); null when no quantitative filter ran"}},"type":"object","required":["stakeholder","exposure_score","exposure_type","rationale","sources_with_quotes"],"title":"ScreenResult"},"SemanticSearchParams":{"properties":{"queries":{"items":{"type":"string","maxLength":2000},"type":"array","maxItems":8,"minItems":1,"title":"Queries","examples":[["Apple iPhone demand outlook","Apple services revenue growth","Apple CEO guidance"]]},"max_tokens":{"type":"integer","maximum":50000.0,"minimum":1000.0,"title":"Max Tokens","description":"Snippet token budget","default":2000},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601","default":"2026-01-01T00:00:00Z"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"min_cosine_similarity":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Cosine Similarity"},"source_metadata_filters":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublisherSourceMetadataFilter"},"type":"array"},{"type":"null"}],"title":"Source Metadata Filters","description":"Exact metadata include/exclude filters."},"entity_types":{"anyOf":[{"items":{"type":"string","enum":["COMPANY","ORGANIZATION","PRODUCT","PERSON","COUNTRY","LOCATION","TREND","EVENT","FINANCIAL_INSTRUMENT","PROBLEM","CURRENCY","TECHNOLOGY","CRYPTO","LEGAL","COMMODITY","GOVERNMENT","INDEX","PROGRAM","FUND","DOMAIN","REAL_ASSET"]},"type":"array"},{"type":"null"}],"title":"Entity Types","description":"Match any."},"min_utility_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Utility Score","description":"0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical","default":0.4},"min_sentiment_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Min Sentiment Score","description":"-1..1; +-.2 neutral; +-.2-.6 mod; +-.6+ strong; mutually exclusive with max_sentiment_score"},"max_sentiment_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Max Sentiment Score"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["queries"],"title":"SemanticSearchParams"},"SemanticSearchResult":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"System imestamp of the document."},"document_id":{"type":"integer","title":"Document Id","description":"Identifier of the indexed document."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Title of the source document, if available."},"snippets":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Snippets","description":"Passage texts from this document, ordered as they appear in the document."},"snippet_cosine_similarities":{"items":{"type":"number"},"type":"array","minItems":1,"title":"Snippet Cosine Similarities","description":"Cosine similarity of each snippet to the query. Same length and order as snippets."},"o200k_base_n_tokens":{"type":"integer","minimum":1.0,"title":"O200K Base N Tokens","description":"o200k_base token count of the returned snippets."},"canonical_entity_names":{"items":{"type":"string"},"type":"array","title":"Canonical Entity Names","description":"Canonical entity names across the returned snippets."},"utility_score":{"type":"number","title":"Utility Score","description":"Token-weighted utility score of the returned snippets, between 0.0 and 1.0."},"sentiment_score":{"type":"number","title":"Sentiment Score","description":"Token-weighted sentiment score of the returned snippets, between -1.0 and 1.0."},"source":{"$ref":"#/components/schemas/Source","description":"Source information."}},"type":"object","required":["timestamp","document_id","title","snippets","snippet_cosine_similarities","o200k_base_n_tokens","canonical_entity_names","utility_score","sentiment_score","source"],"title":"SemanticSearchResult","description":"One document of semantic-search context.\n\nChunks that share a document_id are grouped into parallel snippet arrays so the caller sees\nordered passages from the same document without paying for a nested object key on every snippet.\nsnippet_cosine_similarities[i] always describes snippets[i]. Result order is by each document's\nbest snippet similarity (desc); there is no separate top-level cosine_similarity field because\nthat value is exactly max(snippet_cosine_similarities)."},"SiFactorAssessmentSourceMetadata":{"properties":{"factor_name":{"type":"string","title":"Factor Name","description":"Factor name from the historical assessment."},"stakeholder_symbol":{"type":"string","title":"Stakeholder Symbol","description":"Stakeholder ticker from the historical assessment."}},"type":"object","required":["factor_name","stakeholder_symbol"],"title":"SiFactorAssessmentSourceMetadata","description":"source_metadata for rows where source_table == \"si_factor_assessments\".\n\nLightweight identifiers only; full assessment content is retrieved via source_id.\nAssessments are first-party and have no public root URL; Source.coerce_source_metadata_and_url\nalways mints /source/si_factor_assessments/{id}/{key} onto Source.url."},"SiStakeholderImpactSourceMetadata":{"properties":{"stakeholder_symbol":{"type":"string","title":"Stakeholder Symbol","description":"Stakeholder ticker from the historical impact."},"stakeholder_name":{"type":"string","title":"Stakeholder Name","description":"Stakeholder name from the historical impact."}},"type":"object","required":["stakeholder_symbol","stakeholder_name"],"title":"SiStakeholderImpactSourceMetadata","description":"source_metadata for rows where source_table == \"si_stakeholder_impacts\".\n\nLightweight identifiers only; full impact content (rationale, scores) is retrieved via source_id.\nImpacts are first-party and have no public root URL; Source.coerce_source_metadata_and_url\nalways mints /source/si_stakeholder_impacts/{id}/{key} onto Source.url."},"Source":{"properties":{"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"Timestamp of the source item."},"source_table":{"type":"string","enum":["news","x_news","youtube","feeds","x_posts","tradingview_news","telegram_messages","web","si_factor_assessments","si_stakeholder_impacts","fmp_company_descriptions","fi_documents"],"title":"Source Table","description":"Table (Type) of the source item."},"source_id":{"type":"integer","title":"Source Id","description":"'id' of the source item"},"url":{"type":"string","minLength":1,"title":"Url","description":"Link to the source item. External sources link to the original page; first-party and synthesis sources link to their Ultralayer source page."},"source_metadata":{"anyOf":[{"$ref":"#/components/schemas/NewsSourceMetadata"},{"$ref":"#/components/schemas/XNewsSourceMetadata"},{"$ref":"#/components/schemas/YouTubeSourceMetadata"},{"$ref":"#/components/schemas/FeedsSourceMetadata"},{"$ref":"#/components/schemas/XPostsSourceMetadata"},{"$ref":"#/components/schemas/TradingviewSourceMetadata"},{"$ref":"#/components/schemas/TelegramMessagesSourceMetadata"},{"$ref":"#/components/schemas/WebSourceMetadata"},{"$ref":"#/components/schemas/SiFactorAssessmentSourceMetadata"},{"$ref":"#/components/schemas/SiStakeholderImpactSourceMetadata"},{"$ref":"#/components/schemas/FmpCompanySourceMetadata"},{"$ref":"#/components/schemas/FilingDocumentSourceMetadata"}],"title":"Source Metadata","description":"Per-source metadata."}},"type":"object","required":["source_timestamp","source_table","source_id","url","source_metadata"],"title":"Source","description":"Full source information to be returned to end user."},"SourceWithQuotes":{"properties":{"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"Timestamp of the source item."},"source_table":{"type":"string","enum":["news","x_news","youtube","feeds","x_posts","tradingview_news","telegram_messages","web","si_factor_assessments","si_stakeholder_impacts","fmp_company_descriptions","fi_documents"],"title":"Source Table","description":"Table (Type) of the source item."},"source_id":{"type":"integer","title":"Source Id","description":"'id' of the source item"},"url":{"type":"string","minLength":1,"title":"Url","description":"Link to the source item. External sources link to the original page; first-party and synthesis sources link to their Ultralayer source page."},"source_metadata":{"anyOf":[{"$ref":"#/components/schemas/NewsSourceMetadata"},{"$ref":"#/components/schemas/XNewsSourceMetadata"},{"$ref":"#/components/schemas/YouTubeSourceMetadata"},{"$ref":"#/components/schemas/FeedsSourceMetadata"},{"$ref":"#/components/schemas/XPostsSourceMetadata"},{"$ref":"#/components/schemas/TradingviewSourceMetadata"},{"$ref":"#/components/schemas/TelegramMessagesSourceMetadata"},{"$ref":"#/components/schemas/WebSourceMetadata"},{"$ref":"#/components/schemas/SiFactorAssessmentSourceMetadata"},{"$ref":"#/components/schemas/SiStakeholderImpactSourceMetadata"},{"$ref":"#/components/schemas/FmpCompanySourceMetadata"},{"$ref":"#/components/schemas/FilingDocumentSourceMetadata"}],"title":"Source Metadata","description":"Per-source metadata."},"quotes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Quotes","description":"List of EXACT quotes from the source material."}},"type":"object","required":["source_timestamp","source_table","source_id","url","source_metadata","quotes"],"title":"SourceWithQuotes","description":"Source information with relevant quotes"},"StakeholderBase":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the stakeholder"},"stakeholder_type":{"type":"string","const":"PUBLIC_COMPANY","title":"Stakeholder Type","description":"The type of stakeholder. ONLY the following are allowed: [PUBLIC_COMPANY]."},"symbol":{"type":"string","title":"Symbol","description":"Ticker symbol of the stakeholder"}},"type":"object","required":["name","stakeholder_type","symbol"],"title":"StakeholderBase","description":"Stakeholder information"},"StakeholderIdentificationParams":{"properties":{"query":{"type":"string","maxLength":2000,"title":"Query","examples":["Apple CEO succession Tim Cook to John Ternus"]},"context":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Context","description":"Additional context"},"instructions":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Instructions","description":"Additional guidance"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"As-of system timestamp; inclusive ISO 8601; null=realtime"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:scored+citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["query"],"title":"StakeholderIdentificationParams"},"StakeholderIdentificationResponse":{"properties":{"stakeholder_impacts":{"items":{"$ref":"#/components/schemas/StakeholderImpact"},"type":"array","minItems":0,"title":"Stakeholder Impacts","description":"List of identified stakeholders with their impact details."},"factor_matrix":{"items":{"$ref":"#/components/schemas/FactorMatrixRow"},"type":"array","minItems":0,"title":"Factor Matrix","description":"Comparison dimensions for stakeholders relating to the situation."}},"type":"object","required":["stakeholder_impacts","factor_matrix"],"title":"StakeholderIdentificationResponse","description":"Response model for stakeholder identification"},"StakeholderImpact":{"properties":{"stakeholder":{"$ref":"#/components/schemas/StakeholderBase","description":"The stakeholder being identified."},"impact_score":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Impact Score","description":"+-.5+ strong; 0..+-.5 weak; 0 neutral"},"confidence_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence Score","description":"0-.25 low; .25-.5 med; .5-.75 high; .75-1 very high"},"rationale":{"type":"string","title":"Rationale","description":"Self-contained brief explanation of why this stakeholder is relevant to the query."},"sources_with_quotes":{"items":{"$ref":"#/components/schemas/SourceWithQuotes"},"type":"array","minItems":1,"title":"Sources With Quotes","description":"List of sources (with quotes) that support the identification of this stakeholder."}},"type":"object","required":["stakeholder","impact_score","confidence_score","rationale","sources_with_quotes"],"title":"StakeholderImpact","description":"Stakeholder impact information with relevant sources"},"TelegramMessagesSourceMetadata":{"properties":{"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Channel→publisher taxonomy when known."}},"type":"object","required":["publisher"],"title":"TelegramMessagesSourceMetadata","description":"source_metadata for rows where source_table == \"telegram_messages\".\n\nChannel posts have no title column — only channel→publisher taxonomy."},"TelegramReceiver":{"properties":{"type":{"type":"string","const":"telegram","title":"Type"},"chat_id":{"type":"string","maxLength":64,"title":"Chat Id","description":"Chat ID; start the alerts bot first."}},"additionalProperties":false,"type":"object","required":["type","chat_id"],"title":"TelegramReceiver"},"TradingviewSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"TradingView story title."},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Normalized provider id when known."}},"type":"object","required":["title","publisher"],"title":"TradingviewSourceMetadata","description":"source_metadata for rows where source_table == \"tradingview_news\".\n\nTradingView stories always have a title; publisher is the normalized provider id."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"Title of the web record."},"record_type":{"type":"string","title":"Record Type","description":"Kind of web record (e.g. exa_search, azure_grounded)."}},"type":"object","required":["title","record_type"],"title":"WebSourceMetadata","description":"source_metadata for rows where source_table == \"web\"."},"WebhookReceiver":{"properties":{"type":{"type":"string","const":"webhook","title":"Type"},"url":{"type":"string","maxLength":2048,"title":"Url"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object","maxProperties":4},{"type":"null"}],"title":"Headers","description":"POST headers."},"body_wrap_key":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[A-Za-z0-9_-]+(\\.[A-Za-z0-9_-]+)?$"},{"type":"null"}],"title":"Body Wrap Key","description":"Place the alert envelope under this body key. Dot-separated for one level of nesting (e.g. variables.PAYLOAD)."},"body_wrap_as_string":{"type":"boolean","title":"Body Wrap As String","description":"JSON-encode the envelope to a string before placing it under body_wrap_key. Requires body_wrap_key.","default":false},"body_extra":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"type":"object","maxProperties":10},{"type":"null"}],"title":"Body Extra","description":"Static keys merged into the top level of the body. String, number, boolean or null values only."}},"additionalProperties":false,"type":"object","required":["type","url"],"title":"WebhookReceiver"},"WireAbout":{"properties":{"sectors":{"items":{"type":"string","enum":["communication_services","consumer_discretionary","consumer_staples","energy","financials","health_care","industrials","information_technology","materials","real_estate","utilities"]},"type":"array","title":"Sectors","description":"GICS-style sectors this item is about."},"industries":{"items":{"type":"string"},"type":"array","title":"Industries","description":"Free-form industry labels this item is about."},"countries":{"items":{"type":"string"},"type":"array","title":"Countries","description":"Lowercase country codes this item is about."},"asset_classes":{"items":{"type":"string","enum":["equities","fixed_income","currencies","commodities","crypto","real_estate"]},"type":"array","title":"Asset Classes","description":"Asset classes this item is about."}},"type":"object","title":"WireAbout","description":"Market-level scope dimensions for a wire item. May be inferred, not only explicitly named."},"WireEntityDetail":{"properties":{"entity_id":{"type":"integer","title":"Entity Id","description":"Stable Ultralayer entity id."},"canonical_name":{"type":"string","title":"Canonical Name","description":"Canonical entity name."},"identifiers":{"items":{"type":"string"},"type":"array","title":"Identifiers","description":"Document-grounded lexical references to this entity in the item text."},"entity_type":{"type":"string","title":"Entity Type","description":"Entity type label (e.g. COMPANY, PERSON)."},"relevance":{"type":"string","enum":["primary","significant","contextual","incidental"],"title":"Relevance","description":"How central the entity is to the item."},"sentiment":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Sentiment","description":"-1..1 directional market implication of this item for this entity."}},"type":"object","required":["entity_id","canonical_name","entity_type","relevance","sentiment"],"title":"WireEntityDetail","description":"One grounded entity on a wire item, with per-entity relevance and sentiment."},"WireItem":{"properties":{"wire_id":{"type":"integer","title":"Wire Id","description":"Primary key of the wire row."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Canonical system time when this item was put on the wire."},"source_timestamp":{"type":"string","format":"date-time","title":"Source Timestamp","description":"Source last-update time."},"headline":{"type":"string","title":"Headline","description":"Ultralayer-generated headline."},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Normalized publisher/source label, when known."},"url":{"type":"string","title":"Url","description":"Link to the original item."},"content_type":{"type":"string","enum":["news","analysis","opinion","press_release","data_release"],"title":"Content Type","description":"Kind of item."},"categories":{"items":{"type":"string"},"type":"array","title":"Categories","description":"Multi-label event/theme tags."},"recency":{"type":"string","enum":["realtime","report_of_past","report_of_future"],"title":"Recency","description":"Whether the item is about now, the past, or the future."},"source_relationship":{"type":"string","enum":["first_party","reporting","second_hand"],"title":"Source Relationship","description":"How close the source is to the information."},"factuality":{"type":"string","enum":["confirmed","reported","rumor","speculation","forecast"],"title":"Factuality","description":"Epistemic status of the item's core claim."},"novelty":{"type":"string","enum":["new","update","duplicate","correction"],"title":"Novelty","description":"Story-lifecycle label relative to prior wire items."},"prior_wire_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prior Wire Id","description":"Matched earlier wire item for update|duplicate|correction; null for new."},"trustworthiness_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Trustworthiness Score","description":"0..1 source credibility score."},"importance_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Importance Score","description":"0..1 market-importance score."},"about":{"$ref":"#/components/schemas/WireAbout","description":"Market-level scope dimensions (sectors, industries, countries, asset_classes)."},"entities":{"items":{"$ref":"#/components/schemas/WireEntityDetail"},"type":"array","title":"Entities","description":"Grounded entities with per-entity relevance and sentiment."}},"type":"object","required":["wire_id","timestamp","source_timestamp","headline","publisher","url","content_type","categories","recency","source_relationship","factuality","novelty","prior_wire_id","trustworthiness_score","importance_score","about","entities"],"title":"WireItem","description":"A wire item."},"WireListParams":{"properties":{"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"max_records":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Max Records","default":20},"novelty":{"anyOf":[{"items":{"type":"string","enum":["new","update","duplicate","correction"]},"type":"array","maxItems":4,"minItems":1},{"type":"null"}],"title":"Novelty","description":"Match any."},"content_type":{"anyOf":[{"items":{"type":"string","enum":["news","analysis","opinion","press_release","data_release"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Content Type","description":"Match any."},"recency":{"anyOf":[{"items":{"type":"string","enum":["realtime","report_of_past","report_of_future"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Recency","description":"Match any."},"source_relationship":{"anyOf":[{"items":{"type":"string","enum":["first_party","reporting","second_hand"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Source Relationship","description":"Match any."},"factuality":{"anyOf":[{"items":{"type":"string","enum":["confirmed","reported","rumor","speculation","forecast"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Factuality","description":"Match any."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Categories","description":"Match any.","examples":[["earnings"]]},"entities":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Entities","description":"Match any.","examples":[["Apple Inc.","TSLA"]]},"entity_relevance":{"anyOf":[{"items":{"type":"string","enum":["primary","significant","contextual","incidental"]},"type":"array","maxItems":4,"minItems":1},{"type":"null"}],"title":"Entity Relevance","description":"Match any."},"min_entity_sentiment":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Min Entity Sentiment","description":"+-.2 neutral; +-.2-.6 mod; +-.6+ strong; both: >=min OR <=max"},"max_entity_sentiment":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Max Entity Sentiment"},"sectors":{"anyOf":[{"items":{"type":"string","enum":["communication_services","consumer_discretionary","consumer_staples","energy","financials","health_care","industrials","information_technology","materials","real_estate","utilities"]},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Sectors","description":"Match any."},"industries":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Industries","description":"Match any.","examples":[["automobiles"]]},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Countries","description":"Match any; lowercase ISO 3166-1 alpha-2","examples":[["us"]]},"asset_classes":{"anyOf":[{"items":{"type":"string","enum":["equities","fixed_income","currencies","commodities","crypto","real_estate"]},"type":"array","maxItems":6,"minItems":1},{"type":"null"}],"title":"Asset Classes","description":"Match any."},"publisher":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Publisher","description":"Match any.","examples":[["reuters"]]},"min_importance_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Importance Score","description":"0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical"},"min_trustworthiness_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Trustworthiness Score","description":"<.2 anon; .4-.6 mod; .6+ reputable; .8+ official"},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","title":"WireListParams"},"WireStoryline":{"properties":{"seed_wire_id":{"type":"integer","title":"Seed Wire Id","description":"The wire_id that was requested."},"root_wire_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Root Wire Id","description":"Wire id of the novelty root (prior_wire_id IS NULL) when the ancestor walk reached it; null when the walk stopped early (time window or depth cap)."},"items":{"items":{"$ref":"#/components/schemas/WireItem"},"type":"array","title":"Items","description":"Storyline members ordered by source_timestamp ascending."}},"type":"object","required":["seed_wire_id","root_wire_id","items"],"title":"WireStoryline","description":"Storyline cluster for a seed wire item: ancestor chain plus first-degree branches."},"WireStorylineParams":{"properties":{"wire_id":{"type":"integer","title":"Wire Id"},"start_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Timestamp","description":"System timestamp; Inclusive ISO 8601"},"end_timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Timestamp","description":"System timestamp; Inclusive ISO 8601; null=realtime"},"novelty":{"anyOf":[{"items":{"type":"string","enum":["new","update","duplicate","correction"]},"type":"array","maxItems":4,"minItems":1},{"type":"null"}],"title":"Novelty","description":"Match any.","default":["new","update","correction"]},"max_ancestor_depth":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Max Ancestor Depth","description":"Ancestor cap, including seed.","default":32},"max_children":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Max Children","description":"Branched children cap","default":32},"detail":{"type":"string","enum":["full","standard","essential"],"title":"Detail","description":"essential:minimal; standard:citable; full:all.","default":"full"}},"additionalProperties":false,"type":"object","required":["wire_id"],"title":"WireStorylineParams"},"XNewsSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"X story title."}},"type":"object","required":["title"],"title":"XNewsSourceMetadata","description":"source_metadata for rows where source_table == \"x_news\".\n\nOnly title: source_metadata is reserved for essential or genuinely filterable\nfields. x_id is encoded in Source.url; post_ids live in x_news.cluster_posts_results."},"XPostsSourceMetadata":{"properties":{"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Publisher/rule-tag taxonomy when known."}},"type":"object","required":["publisher"],"title":"XPostsSourceMetadata","description":"source_metadata for rows where source_table == \"x_posts\".\n\nRaw first-party posts have no title column — only publisher taxonomy."},"YouTubeSourceMetadata":{"properties":{"title":{"type":"string","title":"Title","description":"YouTube video title."},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher","description":"Internal publisher key linking related channels, e.g. bloomberg."},"video_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Type","description":"VIDEO, SHORT, or PODCAST when known."},"channel_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel Name","description":"Internal stable channel identity from YT_CONFIG when known."}},"type":"object","required":["title","publisher"],"title":"YouTubeSourceMetadata","description":"source_metadata for rows where source_table == \"youtube\".\n\nFields chosen for search filtering and source presentation: publisher links related\nchannels; video_type distinguishes VIDEO, SHORT, and PODCAST; channel_name is the\ninternal stable channel identity from YT_CONFIG.\n\nvideo_type / channel_name are optional because wire-derived citations only carry\ntitle/publisher from WireItemInternal. The documents-indexing path still sets both."}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}