Signal Ledger Financial Intelligence

{'type': 'object', 'oneOf': [{'not': {'required': ['symbol']}, 'required': ['report_text']}, {'not': {'required': ['report_text']}, 'required': ['symbol']}], 'properties': {'mode': {'enum': ['text', 'symbol'], 'type': 'string', 'description': 'Optional explicit mode. It is inferred from report_text or symbol when omitted.'}, 'period': {'type': 'string', 'default': 'latest', 'pattern': '^(?:latest|FY?20\\d{2}|20\\d{2}(?:Q[1-4]|-Q[1-4]|-\\d{2}-\\d{2})?)$', 'description': 'latest, 2025/FY2025, 2025-Q4 or YYYY-MM-DD.'}, 'symbol': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9.-]{0,14}$', 'description': 'US-listed ticker symbol, for example AAPL or BRK.B. The service fetches an official filing.'}, 'company': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Optional company name for text mode.'}, 'report_text': {'type': 'string', 'maxLength': 100000, 'minLength': 200, 'description': 'Plain text from a financial statement, annual report, quarterly report, SEC 10-K, 10-Q or 8-K filing.'}, 'report_type': {'enum': ['10-K', '10-Q', '8-K'], 'type': 'string', 'default': '10-K', 'description': 'Preferred filing/report type for symbol mode.'}, 'source_context': {'type': 'object', 'properties': {'source_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'source_name': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'metric_basis': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'published_at': {'type': 'string', 'format': 'date-time'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'report_period': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'cross_checked_sources': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2048, 'minLength': 1}, 'maxItems': 5}}, 'description': 'Optional provenance metadata for caller-supplied text.', 'additionalProperties': False}}, 'description': 'Choose exactly one input source: report_text for caller-supplied text, or symbol to fetch an official filing automatically.', 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'request_id'], 'properties': {'ok': {'type': 'boolean'}, 'mode': {'type': 'string'}, 'tool': {'type': 'string'}, 'error': {'type': 'object', 'required': ['code', 'message', 'retryable'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'retryable': {'type': 'boolean'}}}, 'analysis': {'type': 'object', 'required': ['risk_score', 'risk_level', 'risk_category', 'severity', 'evidence_quote', 'source_url', 'report_period', 'confidence', 'data_freshness', 'missing_information', 'recommended_follow_up'], 'properties': {'severity': {'type': 'string'}, 'confidence': {'enum': ['high', 'medium', 'limited'], 'type': 'string'}, 'risk_level': {'type': 'string'}, 'risk_score': {'type': ['number', 'null']}, 'source_url': {'type': ['string', 'null'], 'format': 'uri'}, 'report_period': {'type': ['string', 'null']}, 'risk_category': {'type': 'string'}, 'data_freshness': {'type': 'object'}, 'evidence_quote': {'type': ['string', 'null']}, 'document_sha256': {'type': ['string', 'null'], 'pattern': '^[a-f0-9]{64}$'}, 'source_location': {'type': ['object', 'null']}, 'missing_information': {'type': 'array', 'items': {'type': 'object'}}, 'evidence_verification': {'type': 'string'}, 'recommended_follow_up': {'type': 'array', 'items': {'type': 'string'}}}}, 'scorecard': {'type': 'object'}, 'request_id': {'type': 'string'}}}

{'type': 'object', 'required': ['handle'], 'properties': {'type': {'enum': ['all', 'stock', 'industry', 'market'], 'type': 'string', 'default': 'all', 'description': 'Filter claims by stock, industry or broad-market scope.'}, 'handle': {'type': 'string', 'pattern': '^@?[A-Za-z0-9_]{1,15}$', 'description': 'X/Twitter author handle, with or without @.'}, 'window_days': {'type': 'integer', 'default': 3650, 'maximum': 3650, 'minimum': 1, 'description': 'Historical lookback window in days.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'request_id'], 'properties': {'ok': {'type': 'boolean'}, 'mode': {'type': 'string'}, 'tool': {'type': 'string'}, 'error': {'type': 'object', 'required': ['code', 'message', 'retryable'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'retryable': {'type': 'boolean'}}}, 'analysis': {'type': 'object', 'required': ['risk_score', 'risk_level', 'risk_category', 'severity', 'evidence_quote', 'source_url', 'report_period', 'confidence', 'data_freshness', 'missing_information', 'recommended_follow_up'], 'properties': {'severity': {'type': 'string'}, 'confidence': {'enum': ['high', 'medium', 'limited'], 'type': 'string'}, 'risk_level': {'type': 'string'}, 'risk_score': {'type': ['number', 'null']}, 'source_url': {'type': ['string', 'null'], 'format': 'uri'}, 'report_period': {'type': ['string', 'null']}, 'risk_category': {'type': 'string'}, 'data_freshness': {'type': 'object'}, 'evidence_quote': {'type': ['string', 'null']}, 'document_sha256': {'type': ['string', 'null'], 'pattern': '^[a-f0-9]{64}$'}, 'source_location': {'type': ['object', 'null']}, 'missing_information': {'type': 'array', 'items': {'type': 'object'}}, 'evidence_verification': {'type': 'string'}, 'recommended_follow_up': {'type': 'array', 'items': {'type': 'string'}}}}, 'scorecard': {'type': 'object'}, 'request_id': {'type': 'string'}}}