Gate News MCP

{'type': 'object', 'required': ['query', 'coin'], 'properties': {'coin': {'type': 'string', 'description': 'Target coin, e.g. BTC, ETH. Required at the Tool layer.'}, 'lang': {'type': 'string', 'description': 'zh / en. Default zh.'}, 'mode': {'type': 'string', 'description': 'auto / price_move / event_impact. Default auto.'}, 'query': {'type': 'string', 'description': "User's original question, e.g. 'Why did BTC surge?'"}, 'time_range': {'type': 'string', 'description': 'Time window: 30m/1h/2h/4h/24h. Default 2h.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'coin', 'time_range', 'summary', 'latest_news', 'supporting_events', 'data_status', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'query': {'type': 'string'}, 'summary': {'type': 'string'}, 'time_range': {'type': 'string'}, 'data_status': {'type': 'object', 'required': ['is_partial'], 'properties': {'note': {'type': 'string'}, 'is_partial': {'type': 'boolean'}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'duration_ms': {'type': 'integer'}, 'latest_news': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['title', 'summary', 'source'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'reason': {'type': 'string'}, 'source': {'type': 'string'}, 'summary': {'type': 'string'}, 'first_seen_time': {'type': 'string'}, 'relevance_score': {'type': 'number'}}, 'additionalProperties': False}}, 'supporting_events': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['title', 'summary', 'source'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'reason': {'type': 'string'}, 'source': {'type': 'string'}, 'summary': {'type': 'string'}, 'first_seen_time': {'type': 'string'}, 'relevance_score': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['event_id'], 'properties': {'event_id': {'type': 'string', 'description': 'Required event_id from get_latest_events items—opaque digest id, not a trading pair slug or headline hash.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['event_id', 'duration_ms'], 'properties': {'title': {'type': 'string'}, 'content': {'type': 'string'}, 'summary': {'type': 'string'}, 'symbols': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'event_id': {'type': 'string'}, 'strength': {'type': 'string'}, 'direction': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'occurred_at': {'type': 'string'}, 'news_coverage': {'type': 'string'}, 'impact_analysis': {'type': 'string'}, 'impact_direction': {'type': 'string'}, 'community_reaction': {'type': 'string'}, 'impact_direction_reason': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Optional comma-separated tickers e.g. BTC,ETH for digest items; not the same as search_news tickers-only heat mode.'}, 'limit': {'type': 'integer', 'description': 'Page size; default 20, max 100.'}, 'cursor': {'type': 'string', 'description': 'Optional pagination cursor.'}, 'end_time': {'type': 'string', 'description': 'Absolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range.'}, 'direction': {'type': 'string', 'description': 'Optional filter on persisted impact_direction: positive / negative / neutral / mixed / unknown / all (default all, no filter). MCP does not re-judge direction.'}, 'event_type': {'type': 'string', 'description': 'Optional filter on structured digest event_type. Not search_news headline similarity/heat.'}, 'start_time': {'type': 'string', 'description': 'Absolute start (ISO8601 or Unix sec/ms). Mutually exclusive with time_range; pair with end_time or let server fill the other bound.'}, 'time_range': {'type': 'string', 'description': 'Relative window for event digest list: 1h / 24h / 7d. Mutually exclusive with start_time/end_time; omit all for last 24h or server default when time filter disabled. Not CPI/Fed macro series—use macro indicator tools.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['limit', 'total', 'count', 'items', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['event_id'], 'properties': {'tags': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'context': {'type': 'string'}, 'event_id': {'type': 'string'}, 'event_time': {'type': 'string'}, 'event_type': {'type': 'string'}, 'event_title': {'type': 'string'}, 'price_change': {'type': 'string'}, 'summary_time': {'type': 'string'}, 'related_coins': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'impact_analysis': {'type': 'string'}, 'impact_direction': {'type': 'string'}, 'impact_direction_reason': {'type': 'string'}}, 'additionalProperties': False}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'end_time': {'type': 'string'}, 'direction': {'type': 'string'}, 'event_type': {'type': 'string'}, 'start_time': {'type': 'string'}, 'time_range': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'description': 'Required cryptocurrency symbol, for example BTC or TAIKO; 1-20 characters and normalized to uppercase.'}, 'event_id': {'type': 'string', 'description': 'Optional market-move event ID. When report_id and event_id are omitted, returns the latest report for symbol.'}, 'report_id': {'type': 'string', 'description': 'Optional report ID for an exact lookup. Takes priority over event_id when both are provided.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['report_id', 'event_id', 'candidate_type', 'symbol', 'report_status'], 'properties': {'title': {'type': ['null', 'string'], 'description': 'nullable'}, 'symbol': {'type': 'string'}, 'summary': {'type': ['null', 'string'], 'description': 'nullable'}, 'z_price': {'type': ['null', 'number'], 'description': 'nullable'}, 'event_id': {'type': 'string'}, 'evidence': {'type': ['null', 'object'], 'properties': {'social': {'type': ['null', 'object'], 'required': ['x_available', 'ugc_available', 'ugc_used', 'mention_count'], 'properties': {'ugc_used': {'type': 'boolean'}, 'x_available': {'type': 'boolean'}, 'mention_count': {'type': 'integer'}, 'ugc_available': {'type': 'boolean'}, 'sentiment_label': {'type': 'string'}}, 'description': 'nullable', 'additionalProperties': False}, 'coin_info': {'type': ['null', 'object'], 'required': ['available', 'match_count'], 'properties': {'available': {'type': 'boolean'}, 'match_count': {'type': 'integer'}}, 'description': 'nullable', 'additionalProperties': False}, 'orderbook': {'type': ['null', 'object'], 'required': ['available', 'total', 'count'], 'properties': {'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'available': {'type': 'boolean'}}, 'description': 'nullable', 'additionalProperties': False}, 'market_snapshot': {'type': ['null', 'object'], 'required': ['available'], 'properties': {'price': {'type': ['null', 'number'], 'description': 'nullable'}, 'available': {'type': 'boolean'}, 'change_pct': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_24h': {'type': ['null', 'number'], 'description': 'nullable'}}, 'description': 'nullable', 'additionalProperties': False}, 'technical_analysis': {'type': ['null', 'object'], 'required': ['available'], 'properties': {'signal': {'type': 'string'}, 'available': {'type': 'boolean'}}, 'description': 'nullable', 'additionalProperties': False}, 'explain_market_move': {'type': ['null', 'object'], 'required': ['summary_available', 'latest_news_count', 'supporting_events_count', 'sources', 'supporting_events'], 'properties': {'sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'latest_news_count': {'type': 'integer'}, 'summary_available': {'type': 'boolean'}, 'supporting_events': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'supporting_events_count': {'type': 'integer'}}, 'description': 'nullable', 'additionalProperties': False}}, 'description': 'nullable', 'additionalProperties': False}, 'direction': {'type': ['null', 'string'], 'description': 'nullable'}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string'], 'description': 'Report creation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'event_time': {'type': ['null', 'string'], 'description': 'Market-move event time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'updated_at': {'type': ['null', 'string'], 'description': 'Report update time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix. The report-list start_time/end_time bounds filter this field.'}, 'window_end': {'type': ['null', 'string'], 'description': 'Analysis-window end in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'duration_ms': {'type': 'integer', 'description': 'MCP-to-service-ai-pe call duration; populated by get_market_move_report.'}, 'report_info': {'type': ['null', 'string'], 'description': 'Market-move attribution report in Markdown; null when unavailable or pending.'}, 'source_type': {'type': ['null', 'integer'], 'description': 'nullable'}, 'generated_at': {'type': ['null', 'string'], 'description': 'Report generation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'window_start': {'type': ['null', 'string'], 'description': 'Analysis-window start in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'report_status': {'type': 'string', 'description': 'completed, pending, failed, or not_found.'}, 'storage_error': {'type': 'string'}, 'trigger_label': {'type': ['null', 'string'], 'description': 'nullable'}, 'candidate_type': {'type': 'string'}, 'storage_status': {'type': 'string'}, 'window_end_utc8': {'type': ['null', 'string'], 'description': 'Analysis-window end converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.'}, 'price_change_pct': {'type': ['null', 'number'], 'description': 'nullable'}, 'window_start_utc8': {'type': ['null', 'string'], 'description': 'Analysis-window start converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.'}, 'z_price_threshold': {'type': ['null', 'number'], 'description': 'nullable'}, 'display_expire_time': {'type': ['null', 'string'], 'description': 'Report display-expiration time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'absolute_change_threshold': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'start_time', 'end_time'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum reports to return; omitted or 0 defaults to 20, otherwise allowed range is 1-100.'}, 'symbol': {'type': 'string', 'description': 'Required cryptocurrency symbol, for example ETH; 1-20 characters and normalized to uppercase.'}, 'end_time': {'type': 'string', 'description': 'Required inclusive upper bound for report updated_at in UTC0. Accepts ISO 8601 or YYYY-MM-DD HH:MM:SS; a value without a timezone is interpreted as UTC0, an explicit offset is converted to UTC0, and the value must not precede start_time.'}, 'start_time': {'type': 'string', 'description': 'Required inclusive lower bound for report updated_at in UTC0. Accepts ISO 8601 or YYYY-MM-DD HH:MM:SS; a value without a timezone is interpreted as UTC0, and an explicit offset is converted to UTC0 before calling service-ai-pe.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'reports', 'trace_id', 'duration_ms'], 'properties': {'status': {'type': 'string', 'description': 'ready, generating, not_found, or failed.'}, 'reports': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['report_id', 'event_id', 'candidate_type', 'symbol', 'report_status'], 'properties': {'title': {'type': ['null', 'string'], 'description': 'nullable'}, 'symbol': {'type': 'string'}, 'summary': {'type': ['null', 'string'], 'description': 'nullable'}, 'z_price': {'type': ['null', 'number'], 'description': 'nullable'}, 'event_id': {'type': 'string'}, 'evidence': {'type': ['null', 'object'], 'properties': {'social': {'type': ['null', 'object'], 'required': ['x_available', 'ugc_available', 'ugc_used', 'mention_count'], 'properties': {'ugc_used': {'type': 'boolean'}, 'x_available': {'type': 'boolean'}, 'mention_count': {'type': 'integer'}, 'ugc_available': {'type': 'boolean'}, 'sentiment_label': {'type': 'string'}}, 'description': 'nullable', 'additionalProperties': False}, 'coin_info': {'type': ['null', 'object'], 'required': ['available', 'match_count'], 'properties': {'available': {'type': 'boolean'}, 'match_count': {'type': 'integer'}}, 'description': 'nullable', 'additionalProperties': False}, 'orderbook': {'type': ['null', 'object'], 'required': ['available', 'total', 'count'], 'properties': {'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'available': {'type': 'boolean'}}, 'description': 'nullable', 'additionalProperties': False}, 'market_snapshot': {'type': ['null', 'object'], 'required': ['available'], 'properties': {'price': {'type': ['null', 'number'], 'description': 'nullable'}, 'available': {'type': 'boolean'}, 'change_pct': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_24h': {'type': ['null', 'number'], 'description': 'nullable'}}, 'description': 'nullable', 'additionalProperties': False}, 'technical_analysis': {'type': ['null', 'object'], 'required': ['available'], 'properties': {'signal': {'type': 'string'}, 'available': {'type': 'boolean'}}, 'description': 'nullable', 'additionalProperties': False}, 'explain_market_move': {'type': ['null', 'object'], 'required': ['summary_available', 'latest_news_count', 'supporting_events_count', 'sources', 'supporting_events'], 'properties': {'sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'latest_news_count': {'type': 'integer'}, 'summary_available': {'type': 'boolean'}, 'supporting_events': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'supporting_events_count': {'type': 'integer'}}, 'description': 'nullable', 'additionalProperties': False}}, 'description': 'nullable', 'additionalProperties': False}, 'direction': {'type': ['null', 'string'], 'description': 'nullable'}, 'report_id': {'type': 'string'}, 'created_at': {'type': ['null', 'string'], 'description': 'Report creation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'event_time': {'type': ['null', 'string'], 'description': 'Market-move event time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'updated_at': {'type': ['null', 'string'], 'description': 'Report update time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix. The report-list start_time/end_time bounds filter this field.'}, 'window_end': {'type': ['null', 'string'], 'description': 'Analysis-window end in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'duration_ms': {'type': 'integer', 'description': 'MCP-to-service-ai-pe call duration; populated by get_market_move_report.'}, 'report_info': {'type': ['null', 'string'], 'description': 'Market-move attribution report in Markdown; null when unavailable or pending.'}, 'source_type': {'type': ['null', 'integer'], 'description': 'nullable'}, 'generated_at': {'type': ['null', 'string'], 'description': 'Report generation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'window_start': {'type': ['null', 'string'], 'description': 'Analysis-window start in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'report_status': {'type': 'string', 'description': 'completed, pending, failed, or not_found.'}, 'storage_error': {'type': 'string'}, 'trigger_label': {'type': ['null', 'string'], 'description': 'nullable'}, 'candidate_type': {'type': 'string'}, 'storage_status': {'type': 'string'}, 'window_end_utc8': {'type': ['null', 'string'], 'description': 'Analysis-window end converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.'}, 'price_change_pct': {'type': ['null', 'number'], 'description': 'nullable'}, 'window_start_utc8': {'type': ['null', 'string'], 'description': 'Analysis-window start converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.'}, 'z_price_threshold': {'type': ['null', 'number'], 'description': 'nullable'}, 'display_expire_time': {'type': ['null', 'string'], 'description': 'Report display-expiration time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.'}, 'absolute_change_threshold': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}, 'description': 'Reports whose updated_at is within the requested inclusive UTC0 range, sorted by event_time descending. updated_at may be later than event_time because a generated report can be updated again.'}, 'trace_id': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'to': {'type': 'integer', 'description': 'Window end Unix sec inclusive; forwarded downstream and filtered locally.'}, 'coin': {'type': 'string', 'description': 'Comma-separated tickers; omit if empty.'}, 'from': {'type': 'integer', 'description': 'Window start Unix sec; omit if <= 0; MCP also filters locally after fetch.'}, 'limit': {'type': 'integer', 'description': 'Max rows; omit if unset or <= 0; cap 100 when set.'}, 'query': {'type': 'string', 'description': 'Optional text filter on official venue notices; omit if empty. For general crypto media headlines use search_news—not a substitute for venue-published listing API.'}, 'exchange': {'type': 'string', 'description': 'Venue id for API platform; used when platform is empty; not merged with query.'}, 'platform': {'type': 'string', 'description': 'URL param platform; wins over exchange; if empty falls back to exchange.'}, 'announcement_type': {'type': 'string', 'description': 'listing / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total', 'count', 'items', 'duration_ms'], 'properties': {'to': {'type': 'integer'}, 'coin': {'type': 'string'}, 'from': {'type': 'integer'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'exchange': {'type': 'string'}, 'platform': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'announcement_type': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Required non-empty cryptocurrency ticker, for example ETH. Leading and trailing whitespace is removed and the value is normalized to uppercase. Unknown or no-data tickers may return an empty result with hide_reason=no_data; no coin-dictionary validation is performed.'}, 'limit': {'type': 'integer', 'description': 'Number of hot topics to return. Default 4; allowed range 2 to 4.'}, 'window': {'type': 'string', 'description': 'Aggregation window. Only 4h is currently supported; default 4h.'}, 'platforms': {'type': 'string', 'description': 'Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['coin', 'window', 'topics', 'generated_at', 'hide_reason', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'topics': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['topic_id', 'topic_key', 'topic_titles', 'direction', 'summary', 'platforms', 'post_count', 'engagement_sum', 'topic_influence_score', 'sentiment_score', 'evidence_posts'], 'properties': {'summary': {'type': 'string'}, 'topic_id': {'type': 'string'}, 'direction': {'type': 'string', 'description': 'up, down, or neutral.'}, 'platforms': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'topic_key': {'type': 'string'}, 'post_count': {'type': 'integer'}, 'topic_titles': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'engagement_sum': {'type': 'number'}, 'evidence_posts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['post_id', 'platform'], 'properties': {'post_id': {'type': 'string'}, 'platform': {'type': 'string'}, 'clean_text': {'type': 'string'}, 'author_name': {'type': 'string'}, 'engagement_count': {'type': 'integer'}, 'single_post_summary_zh': {'type': 'string'}}, 'additionalProperties': False}}, 'sentiment_score': {'type': ['null', 'number'], 'description': 'Average topic sentiment; null when unavailable.'}, 'topic_influence_score': {'type': 'number', 'description': 'Topic influence score from 0 to 100.'}}, 'additionalProperties': False}, 'description': 'Two to four qualified topics, or an empty array when evidence is insufficient.'}, 'window': {'type': 'string'}, 'trace_id': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'hide_reason': {'type': ['null', 'string'], 'description': 'no_data or insufficient_evidence when topics should be hidden; null when displayable.'}, 'generated_at': {'type': 'integer', 'description': 'Upstream generation time as Unix seconds.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Required non-empty cryptocurrency ticker, for example BTC. Leading and trailing whitespace is removed and the value is normalized to uppercase. Unknown or no-data tickers may return an empty result with hide_reason=no_data; no coin-dictionary validation is performed.'}, 'window': {'type': 'string', 'description': 'Aggregation window. Only 24h is currently supported; default 24h.'}, 'platforms': {'type': 'string', 'description': 'Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['coin', 'window', 'is_burst', 'current_mention_count', 'previous_mention_count', 'current_weighted_mention_count', 'previous_weighted_mention_count', 'growth_rate', 'sentiment_direction', 'display_color', 'platform_breakdown', 'evidence_summary', 'hide_reason', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'window': {'type': 'string'}, 'is_burst': {'type': 'boolean', 'description': 'True when the upstream burst thresholds for baseline, sample size, and growth are all met.'}, 'trace_id': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'growth_rate': {'type': ['null', 'number'], 'description': 'Weighted mention growth versus the previous 24h; null when no baseline exists.'}, 'hide_reason': {'type': ['null', 'string'], 'description': 'Why the signal should be hidden: no_data, insufficient_baseline, insufficient_sample, or not_burst; null when displayable.'}, 'display_color': {'type': 'string', 'description': 'Display color generated by the upstream service: red, green, or neutral.'}, 'evidence_summary': {'type': ['null', 'string'], 'description': 'Human-readable evidence summary; null when unavailable.'}, 'platform_breakdown': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['platform', 'current_mention_count', 'previous_mention_count', 'current_weighted_mention_count', 'previous_weighted_mention_count', 'growth_rate', 'sentiment_score'], 'properties': {'platform': {'type': 'string'}, 'growth_rate': {'type': ['null', 'number'], 'description': 'Weighted mention growth versus the previous window; null when no baseline exists.'}, 'sentiment_score': {'type': ['null', 'number'], 'description': 'Platform sentiment score; null when unavailable.'}, 'current_mention_count': {'type': 'integer'}, 'previous_mention_count': {'type': 'integer'}, 'current_weighted_mention_count': {'type': 'number'}, 'previous_weighted_mention_count': {'type': 'number'}}, 'additionalProperties': False}}, 'sentiment_direction': {'type': 'string', 'description': 'bullish, bearish, or neutral.'}, 'current_mention_count': {'type': 'integer'}, 'previous_mention_count': {'type': 'integer'}, 'current_weighted_mention_count': {'type': 'number'}, 'previous_weighted_mention_count': {'type': 'number'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Tickers e.g. BTC or BTC,ETH for per-coin aggregates: overall sentiment, positive/negative split, mention count, sample tweets (top_tweets order); omit defaults to BTC server-side. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc.'}, 'time_range': {'type': 'string', 'description': '1h / 24h (default) / 7d window for per-coin sentiment aggregation (overall sentiment, positive/negative split, mention count).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['overall_sentiment', 'sentiment_label', 'mention_count', 'sentiment_distribution', 'top_tweets', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'time_range': {'type': 'string'}, 'top_tweets': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'duration_ms': {'type': 'integer'}, 'mention_count': {'type': 'integer'}, 'sentiment_label': {'type': 'string'}, 'overall_sentiment': {'type': 'number'}, 'sentiment_label_raw': {'type': 'string'}, 'sentiment_distribution': {'type': ['null', 'object'], 'required': ['positive_ratio', 'negative_ratio', 'neutral_ratio'], 'properties': {'neutral_count': {'type': 'integer'}, 'neutral_ratio': {'type': 'number'}, 'negative_count': {'type': 'integer'}, 'negative_ratio': {'type': 'number'}, 'positive_count': {'type': 'integer'}, 'positive_ratio': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Comma-separated tickers mapped to API tickers; sent only when query is empty (omitted when query is set). Heat mode supports news-item / briefing-style lists on the platform index—not open-web synthesis (web_search).'}, 'lang': {'type': 'string', 'description': 'MCP-only filter on metadata.lang or top-level lang; not sent to upstream API.'}, 'page': {'type': 'integer', 'description': 'Page number mapped to API page; default 1.'}, 'limit': {'type': 'integer', 'description': 'Page size mapped to API page_size; default 10, max 100.'}, 'query': {'type': 'string', 'description': 'Non-empty: similarity mode (no tickers; default similarity_score 0.6). Empty: heat mode (top_total_score 1; optional coin/tickers). Platform news index for headlines, news items, and briefing-style result lists—not open-web research with synthesized answers and cited external pages (web_search) or event catalog with event_id (get_latest_events).'}, 'sort_by': {'type': 'string', 'description': 'e.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort.'}, 'end_time': {'type': 'string', 'description': 'End time mapped to API to (Unix sec). Ignored when time_range is set. End-only defaults start to 24h before end.'}, 'platform': {'type': 'string', 'description': 'Source platform name for API platform (e.g. panews, theblock).'}, 'start_time': {'type': 'string', 'description': 'Start time (ISO8601 or Unix sec/ms) mapped to API from. Ignored when time_range is set. Start-only defaults end to now; both empty defaults last 7d when time_range is also empty.'}, 'time_range': {'type': 'string', 'description': 'Optional preset window: 1h / 24h (default when preset value invalid) / 7d / 30d. When non-empty, overrides start_time/end_time and maps to API from/to (Unix epoch seconds). Omit to use start_time/end_time or implicit last-7d when both are empty.'}, 'platform_type': {'type': 'string', 'description': 'Legacy: maps to API platform when platform is omitted; omit platform when value is all.'}, 'top_total_score': {'type': ['null', 'integer'], 'description': 'Only when query empty (0 or 1); non-empty query forces similarity mode.'}, 'similarity_score': {'type': 'string', 'description': 'Similarity threshold; default 0.6 when query set; when query empty only sent if explicitly set.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['from', 'to', 'top_total_score', 'total', 'count', 'items', 'duration_ms'], 'properties': {'to': {'type': 'integer'}, 'coin': {'type': 'string'}, 'from': {'type': 'integer'}, 'lang': {'type': 'string'}, 'page': {'type': 'integer'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'sort_by': {'type': 'string'}, 'end_time': {'type': 'string'}, 'platform': {'type': 'string'}, 'page_size': {'type': 'integer'}, 'start_time': {'type': 'string'}, 'time_range': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'platform_type': {'type': 'string'}, 'top_total_score': {'type': 'integer'}, 'similarity_score': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Ticker filter; with query filters results; without query required with index for OpenSearch list mode.'}, 'limit': {'type': 'integer', 'description': 'Max items; default 10, max 50.'}, 'query': {'type': 'string', 'description': 'Optional NL query; non-empty uses vector search. May combine with coin; both empty is invalid.'}, 'domain': {'type': 'string', 'description': 'UGC topical bucket: crypto / defi / finance / macro / ai_agent / web3_dev / all (default all). macro = social discussion about macro themes, not CPI/Fed/unemployment statistics (use macro data tools) or get_latest_events.'}, 'channel': {'type': 'string', 'description': 'Optional source channel e.g. r/ethereum or handle.'}, 'sort_by': {'type': 'string', 'description': 'relevance (default) / upvotes / recent.'}, 'platform': {'type': 'string', 'description': 'reddit / discord / telegram / youtube / all (default all).'}, 'time_range': {'type': 'string', 'description': '1h / 24h / 7d (default) / 30d / all.'}, 'quality_tier': {'type': 'string', 'description': 'A (default, high quality) / B / all.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total', 'count', 'items', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'domain': {'type': 'string'}, 'channel': {'type': 'string'}, 'sort_by': {'type': 'string'}, 'platform': {'type': 'string'}, 'time_range': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'quality_tier': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'days': {'type': 'integer', 'description': 'Lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly set.'}, 'lang': {'type': 'string', 'description': 'Answer language: zh (default) / en / auto.'}, 'model': {'type': 'string', 'description': 'Override configured Grok model id.'}, 'query': {'type': 'string', 'description': 'X/Twitter topic for tweet-level evidence and cited posts; English recommended. Empty returns no results. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc.'}, 'time_range': {'type': 'string', 'description': 'Preferred recency window for search_x: 1h / 24h (default) / 7d. Takes precedence over days when set.'}, 'allowed_handles': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Include these X handles without @, max 10; mutually exclusive with excluded_handles.'}, 'excluded_handles': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Exclude these handles, max 10.'}, 'enable_image_understanding': {'type': 'boolean', 'description': 'Analyze images in posts.'}, 'enable_video_understanding': {'type': 'boolean', 'description': 'Analyze video in posts.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['summary', 'content', 'sentiment_label', 'key_points', 'cited_tweets', 'total', 'count', 'items', 'duration_ms'], 'properties': {'days': {'type': 'integer'}, 'lang': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'model': {'type': 'string'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'source': {'type': 'string'}, 'content': {'type': 'string', 'description': 'Same as summary for legacy clients; tweet-level X/Twitter evidence—not headline index (search_news).'}, 'summary': {'type': 'string', 'description': 'xAI: synthesized narrative from X/Twitter discussions with tweet-level evidence (same as content; always present). Not open-web synthesis with cited external pages (web_search). Not per-coin sentiment KPIs over a time range (get_social_sentiment).'}, 'to_date': {'type': 'string'}, 'from_date': {'type': 'string'}, 'disclaimer': {'type': 'string', 'description': 'Fixed disclaimer on successful xAI response.'}, 'key_points': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'xAI: bullet points from cited posts; empty array if none. Not briefing-style platform news lists (search_news).'}, 'duration_ms': {'type': 'integer'}, 'cited_tweets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['author', 'content', 'url', 'likes', 'reposts'], 'properties': {'url': {'type': 'string'}, 'likes': {'type': 'integer'}, 'author': {'type': 'string'}, 'content': {'type': 'string'}, 'reposts': {'type': 'integer'}}, 'additionalProperties': False}, 'description': 'xAI: tweet-level evidence and cited posts; fields depend on model and citations.'}, 'allowed_handles': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'sentiment_label': {'type': 'string', 'description': 'xAI: bullish / bearish / neutral for the discussion; empty if unknown. Not per-coin sentiment label KPIs (get_social_sentiment).'}, 'sentiment_score': {'type': ['null', 'integer'], 'description': 'xAI: 0-100 tone for this X/Twitter topic; JSON null if unknown; pairs with sentiment_label. Not per-coin aggregate positive/negative split (get_social_sentiment).'}, 'excluded_handles': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Optional ticker or project (e.g. BTC, ETH) to focus the open-web synthesized answer—not platform news index tickers (search_news).'}, 'lang': {'type': 'string', 'description': 'Answer language: zh (default) / en / auto.'}, 'mode': {'type': 'string', 'description': 'Answer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD).'}, 'limit': {'type': 'integer', 'description': 'Max cited external pages in the answer; default 5, max 10.'}, 'query': {'type': 'string', 'description': 'Required NL question: search the open web and return a synthesized answer with cited external pages—not built-in headline lookup, news-item search, or briefing-style news list (search_news), nor X/Twitter-only discussion or tweet-level evidence (search_x).'}, 'time_range': {'type': 'string', 'description': 'Recency window for open-web synthesis with cited external pages: 1h / 24h (default) / 7d / 30d. Not DeFi/TVL dashboard metrics (use platform-metrics tools).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['summary', 'key_points', 'cited_sources', 'total', 'count', 'items', 'duration_ms'], 'properties': {'coin': {'type': 'string'}, 'lang': {'type': 'string'}, 'mode': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'model': {'type': 'string'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'source': {'type': 'string'}, 'summary': {'type': 'string'}, 'disclaimer': {'type': 'string'}, 'key_points': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'time_range': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'cited_sources': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['title', 'url', 'source', 'publish_time', 'snippet'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'source': {'type': 'string'}, 'snippet': {'type': 'string'}, 'publish_time': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['event_ref'], 'properties': {'venue': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Optional; each non-empty value must equal event_ref venue or invalid_param.'}, 'window': {'type': 'string', 'description': 'Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive).'}, 'event_ref': {'type': 'string', 'description': 'Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events.'}, 'include_markets': {'type': ['null', 'boolean'], 'description': 'Omitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex.'}, 'include_orderbook_summary': {'type': 'boolean', 'description': 'Deprecated and ignored; depth_summary is always null—use get_market_orderbook.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partial', 'missing_sources', 'event_identity', 'signal_time', 'source_data_status', 'outcome_probabilities', 'depth_summary', 'volume_flow', 'directional_context', 'duration_ms'], 'properties': {'window': {'type': 'string'}, 'markets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['venue_market_id', 'market_title', 'is_lead_market'], 'properties': {'market_title': {'type': 'string'}, 'liquidity_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'market_status': {'type': 'string'}, 'is_lead_market': {'type': 'boolean'}, 'price_bar_time': {'type': ['null', 'string'], 'description': 'nullable'}, 'volume_24h_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'venue_market_id': {'type': 'string'}, 'volume_total_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'mid_yes_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_change_6h': {'type': ['null', 'number'], 'description': 'nullable'}, 'market_category_ai_primary': {'type': ['null', 'string'], 'description': 'nullable'}}, 'additionalProperties': False}}, 'partial': {'type': 'boolean'}, 'duration_ms': {'type': 'integer'}, 'signal_time': {'type': 'string'}, 'volume_flow': {'type': 'object', 'required': ['source'], 'properties': {'source': {'type': 'string'}, 'total_liquidity_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'total_volume_usd_24h': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}, 'daily_ranking': {'type': ['null', 'object'], 'properties': {'daily_rank_by_venue': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'volume_delta': {'type': ['null', 'integer'], 'description': 'nullable'}, 'fastest_rising': {'type': ['null', 'integer'], 'description': 'nullable'}}, 'additionalProperties': False}}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_delta_today': {'type': ['null', 'number'], 'description': 'nullable'}}, 'description': 'nullable', 'additionalProperties': False}, 'depth_summary': {'type': ['null', 'object'], 'properties': {'spread_yes': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_no_ask': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_no_bid': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_yes_ask': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_yes_bid': {'type': ['null', 'number'], 'description': 'nullable'}}, 'description': 'nullable', 'additionalProperties': False}, 'event_identity': {'type': 'object', 'required': ['event_ref', 'venue', 'venue_event_id', 'venue_event_title', 'status_tags', 'market_count'], 'properties': {'venue': {'type': 'string'}, 'event_ref': {'type': 'string'}, 'status_tags': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'market_count': {'type': 'integer'}, 'venue_event_id': {'type': 'string'}, 'venue_event_title': {'type': 'string'}, 'category_ai_primary': {'type': ['null', 'string'], 'description': 'nullable'}}, 'additionalProperties': False}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}, 'directional_context': {'type': 'object', 'additionalProperties': True}, 'outcome_probabilities': {'type': 'object', 'properties': {'no_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'yes_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_change_1h': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_change_6h': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_change_24h': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}, 'cross_venue_divergence': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': ['null', 'integer'], 'description': 'Page size; default 20, max 100.'}, 'venue': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Optional venue filter. Allowed: polymarket, predict_fun.'}, 'status': {'type': 'string', 'description': 'Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.'}, 'category': {'type': 'string', 'description': 'Optional category filter: exact term on rank index field category; omit or all to disable.'}, 'date_utc': {'type': 'string', 'description': 'UTC date in YYYY-MM-DD. Defaults to today_utc.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partial', 'missing_sources', 'rank_date_utc', 'generated_at', 'overall', 'by_venue', 'excluded_reasons', 'source_data_status', 'duration_ms'], 'properties': {'overall': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['rank_no', 'venue', 'venue_event_id', 'event_name', 'source_data_status', 'excluded_reasons'], 'properties': {'venue': {'type': 'string'}, 'rank_no': {'type': 'integer'}, 'event_name': {'type': 'string'}, 'market_name': {'type': ['null', 'string'], 'description': 'nullable'}, 'lead_market_id': {'type': ['null', 'string'], 'description': 'nullable'}, 'venue_event_id': {'type': 'string'}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}, 'latest_mid_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_delta_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'open_mid_probability_utc': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}}, 'partial': {'type': 'boolean'}, 'by_venue': {'type': 'object', 'additionalProperties': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['rank_no', 'venue', 'venue_event_id', 'event_name', 'source_data_status', 'excluded_reasons'], 'properties': {'venue': {'type': 'string'}, 'rank_no': {'type': 'integer'}, 'event_name': {'type': 'string'}, 'market_name': {'type': ['null', 'string'], 'description': 'nullable'}, 'lead_market_id': {'type': ['null', 'string'], 'description': 'nullable'}, 'venue_event_id': {'type': 'string'}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}, 'latest_mid_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_delta_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'open_mid_probability_utc': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}}}, 'duration_ms': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'rank_date_utc': {'type': 'string'}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['venue', 'market_id'], 'properties': {'mode': {'type': 'string', 'description': 'Empty or current only (default current). history and other values rejected.'}, 'depth': {'type': ['null', 'integer'], 'description': 'yes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param.'}, 'venue': {'type': 'string', 'description': 'Required. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error).'}, 'end_time': {'type': 'string', 'description': 'Unsupported; if set, request is rejected.'}, 'market_id': {'type': 'string', 'description': 'Required. polymarket: venue_market_id in dws_prediction_market_hf (token lookup). predict_fun: official numeric id (e.g. 356640), not polymarket venue_market_id.'}, 'page_token': {'type': 'string', 'description': 'Unsupported; if set, request is rejected.'}, 'start_time': {'type': 'string', 'description': 'Unsupported; if set, request is rejected.'}, 'granularity': {'type': 'string', 'description': 'Unsupported; if set, request is rejected.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partial', 'missing_sources', 'venue', 'market_id', 'source_api', 'mode', 'snapshot_time', 'book_levels', 'source_data_status', 'duration_ms'], 'properties': {'mode': {'type': 'string'}, 'venue': {'type': 'string'}, 'partial': {'type': 'boolean'}, 'market_id': {'type': 'string'}, 'source_api': {'type': 'string'}, 'book_levels': {'type': ['null', 'object'], 'required': ['yes_bids', 'yes_asks'], 'properties': {'yes_asks': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['price', 'size'], 'properties': {'size': {'type': 'number'}, 'price': {'type': 'number'}}, 'additionalProperties': False}}, 'yes_bids': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['price', 'size'], 'properties': {'size': {'type': 'number'}, 'price': {'type': 'number'}}, 'additionalProperties': False}}, 'spread_no': {'type': ['null', 'number'], 'description': 'nullable'}, 'spread_yes': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_no_ask': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_no_bid': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_yes_ask': {'type': ['null', 'number'], 'description': 'nullable'}, 'best_yes_bid': {'type': ['null', 'number'], 'description': 'nullable'}, 'top5_depth_ask_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'top5_depth_bid_usd': {'type': ['null', 'number'], 'description': 'nullable'}}, 'description': 'nullable', 'additionalProperties': False}, 'duration_ms': {'type': 'integer'}, 'snapshot_time': {'type': ['null', 'string'], 'description': 'nullable'}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': ['null', 'integer'], 'description': 'Page size; default 20, max 100.'}, 'venue': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Optional venue filter. Allowed: polymarket, predict_fun.'}, 'status': {'type': 'string', 'description': 'Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.'}, 'category': {'type': 'string', 'description': 'Optional category filter: exact term on rank index field category; omit or all to disable.'}, 'date_utc': {'type': 'string', 'description': 'UTC date in YYYY-MM-DD. Defaults to today_utc.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partial', 'missing_sources', 'rank_date_utc', 'generated_at', 'overall', 'by_venue', 'excluded_reasons', 'source_data_status', 'duration_ms'], 'properties': {'overall': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['rank_no', 'venue', 'venue_event_id', 'event_name', 'source_data_status', 'excluded_reasons'], 'properties': {'venue': {'type': 'string'}, 'rank_no': {'type': 'integer'}, 'event_name': {'type': 'string'}, 'market_name': {'type': ['null', 'string'], 'description': 'nullable'}, 'lead_market_id': {'type': ['null', 'string'], 'description': 'nullable'}, 'venue_event_id': {'type': 'string'}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}, 'latest_mid_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_delta_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'open_mid_probability_utc': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}}, 'partial': {'type': 'boolean'}, 'by_venue': {'type': 'object', 'additionalProperties': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['rank_no', 'venue', 'venue_event_id', 'event_name', 'source_data_status', 'excluded_reasons'], 'properties': {'venue': {'type': 'string'}, 'rank_no': {'type': 'integer'}, 'event_name': {'type': 'string'}, 'market_name': {'type': ['null', 'string'], 'description': 'nullable'}, 'lead_market_id': {'type': ['null', 'string'], 'description': 'nullable'}, 'venue_event_id': {'type': 'string'}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}, 'latest_mid_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'volume_delta_usd_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'probability_delta_today': {'type': ['null', 'number'], 'description': 'nullable'}, 'open_mid_probability_utc': {'type': ['null', 'number'], 'description': 'nullable'}}, 'additionalProperties': False}}}, 'duration_ms': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'rank_date_utc': {'type': 'string'}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'excluded_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'source_data_status': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'Optional coin ticker; cannot be used alone without query or category (unsupported_filter). With query/category expands text recall only (best_effort).'}, 'limit': {'type': ['null', 'integer'], 'description': 'Page size; default 20, max 100.'}, 'query': {'type': 'string', 'description': 'Optional full-text query; all of query, coin, category are optional.'}, 'venue': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Optional venue filter. Allowed: polymarket, predict_fun.'}, 'status': {'type': 'string', 'description': 'Filter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array.'}, 'sort_by': {'type': 'string', 'description': 'Sort key; default attention. Allowed: attention, volume, liquidity, recently_listed, probability_change, volume_delta_today (maps to total_volume_usd_24h on signal index).'}, 'category': {'type': 'string', 'description': 'Optional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary.'}, 'page_token': {'type': 'string', 'description': 'Base64URL page token from prior next_page_token; filters must match first page.'}, 'with_markets': {'type': 'boolean', 'description': 'When true, attach market summaries from source_markets_json or predictionMarketIndex.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partial', 'events', 'duration_ms'], 'properties': {'events': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['event_ref', 'venue', 'venue_event_id', 'venue_event_title', 'status_tags', 'market_count'], 'properties': {'venue': {'type': 'string'}, 'markets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['venue_market_id', 'market_title'], 'properties': {'market_title': {'type': 'string'}, 'liquidity_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'market_status': {'type': 'string'}, 'volume_24h_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'venue_market_id': {'type': 'string'}, 'market_category_primary': {'type': ['null', 'string'], 'description': 'nullable'}}, 'additionalProperties': False}}, 'event_ref': {'type': 'string'}, 'status_tags': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'market_count': {'type': 'integer'}, 'lead_market_id': {'type': ['null', 'string'], 'description': 'nullable'}, 'venue_event_id': {'type': 'string'}, 'attention_score': {'type': ['null', 'number'], 'description': 'nullable'}, 'venue_event_title': {'type': 'string'}, 'category_ai_primary': {'type': ['null', 'string'], 'description': 'nullable'}, 'total_liquidity_usd': {'type': ['null', 'number'], 'description': 'nullable'}, 'lead_yes_probability': {'type': ['null', 'number'], 'description': 'nullable'}, 'total_volume_usd_24h': {'type': ['null', 'number'], 'description': 'nullable'}, 'market_category_ai_primary': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'partial': {'type': 'boolean'}, 'duration_ms': {'type': 'integer'}, 'missing_sources': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'next_page_token': {'type': ['null', 'string'], 'description': 'nullable'}, 'coin_filter_mode': {'type': 'string'}, 'effective_sort_by': {'type': 'string', 'description': 'Actual sort applied (equals sort_by unless ES sort fallback).'}}, 'additionalProperties': False}