Gate News MCP
Gate news MCP for crypto news, structured events, announcements, and social sentiment.
Should I use this
Quality & Safety
A
Findings (8)
- LOWTool 'news_events_explain_market_move' name length outside 3-30 rangein news_events_explain_market_move
- LOWTool 'news_events_get_market_move_report' name length outside 3-30 rangein news_events_get_market_move_report
- LOWTool 'news_events_list_market_move_reports' name length outside 3-30 rangein news_events_list_market_move_reports
- LOWTool 'news_feed_get_exchange_announcements' name length outside 3-30 rangein news_feed_get_exchange_announcements
- LOWTool 'news_prediction_get_event_signal' name length outside 3-30 rangein news_prediction_get_event_signal
- LOWTool 'news_prediction_get_fastest_rising_ranking' name length outside 3-30 rangein news_prediction_get_fastest_rising_ranking
- LOWTool 'news_prediction_get_market_orderbook' name length outside 3-30 rangein news_prediction_get_market_orderbook
- LOWTool 'news_prediction_get_volume_delta_ranking' name length outside 3-30 rangein news_prediction_get_volume_delta_ranking
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~13,788Tokens (tool definitions)
~8.4 KBTypical response size
Significant attention impact (10.77% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"gate-news": {
"url": "https://api.gatemcp.ai/mcp/news"
}
}
}Remote endpoints
https://api.gatemcp.ai/mcp/newsstreamable-httpWhat it can do
Tool inventory
Tools (18)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢news_events_explain_market_move(query, coin, time_range, mode, lang)
[Read] Explain what drove a crypto asset's price move in a given time window. Returns a concise summary (from real-time Tavily search), the latest high-priority real-time events, and supporting internal event pool items, plus data-completeness status. This tool is a data aggregator; the downstream agent performs the final attribution reasoning. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "User's original question, e.g. 'Why did BTC surge?'"
},
"coin": {
"type": "string",
"description": "Target coin, e.g. BTC, ETH. Required at the Tool layer."
},
"time_range": {
"type": "string",
"description": "Time window: 30m/1h/2h/4h/24h. Default 2h."
},
"mode": {
"type": "string",
"description": "auto / price_move / event_impact. Default auto."
},
"lang": {
"type": "string",
"description": "zh / en. Default zh."
}
},
"required": [
"query",
"coin"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"data_status": {
"additionalProperties": false,
"properties": {
"is_partial": {
"type": "boolean"
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"note": {
"type": "string"
}
},
"required": [
"is_partial"
],
"type": "object"
},
"duration_ms": {
"type": "integer"
},
"latest_news": {
"items": {
"additionalProperties": false,
"properties": {
"first_seen_time": {
"type": "string"
},
"reason": {
"type": "string"
},
"relevance_score": {
"type": "number"
},
"source": {
"type": "string"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"summary",
"source"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"query": {
"type": "string"
},
"summary": {
"type": "string"
},
"supporting_events": {
"items": {
"additionalProperties": false,
"properties": {
"first_seen_time": {
"type": "string"
},
"reason": {
"type": "string"
},
"relevance_score": {
"type": "number"
},
"source": {
"type": "string"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"summary",
"source"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"time_range": {
"type": "string"
}
},
"required": [
"query",
"coin",
"time_range",
"summary",
"latest_news",
"supporting_events",
"data_status",
"duration_ms"
],
"additionalProperties": false
}🟢news_events_get_event_detail(event_id)
[Read] Full detail for one event_id only, including persisted impact_direction and impact_direction_reason. Filtered event list or timeline -> get_latest_events. Unknown id returns not found. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"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."
}
},
"required": [
"event_id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"community_reaction": {
"type": "string"
},
"content": {
"type": "string"
},
"direction": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"event_id": {
"type": "string"
},
"impact_analysis": {
"type": "string"
},
"impact_direction": {
"type": "string"
},
"impact_direction_reason": {
"type": "string"
},
"news_coverage": {
"type": "string"
},
"occurred_at": {
"type": "string"
},
"strength": {
"type": "string"
},
"summary": {
"type": "string"
},
"symbols": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"title": {
"type": "string"
}
},
"required": [
"event_id",
"duration_ms"
],
"additionalProperties": false
}🟢news_events_get_latest_events(event_type, coin, time_range, direction, limit, ...)
[Read] Filtered event list or timeline; each row includes event_id and persisted impact_direction/impact_direction_reason. Optional direction filter. One event_id detail -> get_event_detail. Headline/news feed -> search_news. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"event_type": {
"type": "string",
"description": "Optional filter on structured digest event_type. Not search_news headline similarity/heat."
},
"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."
},
"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."
},
"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."
},
"limit": {
"type": "integer",
"description": "Page size; default 20, max 100."
},
"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."
},
"end_time": {
"type": "string",
"description": "Absolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range."
},
"cursor": {
"type": "string",
"description": "Optional pagination cursor."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"direction": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"end_time": {
"type": "string"
},
"event_type": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"context": {
"type": "string"
},
"event_id": {
"type": "string"
},
"event_time": {
"type": "string"
},
"event_title": {
"type": "string"
},
"event_type": {
"type": "string"
},
"impact_analysis": {
"type": "string"
},
"impact_direction": {
"type": "string"
},
"impact_direction_reason": {
"type": "string"
},
"price_change": {
"type": "string"
},
"related_coins": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"summary_time": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
}
},
"required": [
"event_id"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"limit": {
"type": "integer"
},
"start_time": {
"type": "string"
},
"time_range": {
"type": "string"
},
"total": {
"type": "integer"
}
},
"required": [
"limit",
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_events_get_market_move_report(symbol, report_id, event_id)
[Read] Query a stored market-move attribution report by symbol, optional report_id, or optional event_id. Lookup priority is report_id > event_id > latest report for symbol. Returned event/report timestamps are UTC0 unless the field name ends in _utc8. This tool never requests report regeneration and does not expose is_make_new. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Required cryptocurrency symbol, for example BTC or TAIKO; 1-20 characters and normalized to uppercase."
},
"report_id": {
"type": "string",
"description": "Optional report ID for an exact lookup. Takes priority over event_id when both are provided."
},
"event_id": {
"type": "string",
"description": "Optional market-move event ID. When report_id and event_id are omitted, returns the latest report for symbol."
}
},
"required": [
"symbol"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"absolute_change_threshold": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"candidate_type": {
"type": "string"
},
"created_at": {
"description": "Report creation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"direction": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"display_expire_time": {
"description": "Report display-expiration time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"duration_ms": {
"description": "MCP-to-service-ai-pe call duration; populated by get_market_move_report.",
"type": "integer"
},
"event_id": {
"type": "string"
},
"event_time": {
"description": "Market-move event time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"evidence": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"coin_info": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"match_count": {
"type": "integer"
}
},
"required": [
"available",
"match_count"
],
"type": [
"null",
"object"
]
},
"explain_market_move": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"latest_news_count": {
"type": "integer"
},
"sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"summary": {
"type": "string"
},
"summary_available": {
"type": "boolean"
},
"supporting_events": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"supporting_events_count": {
"type": "integer"
}
},
"required": [
"summary_available",
"latest_news_count",
"supporting_events_count",
"sources",
"supporting_events"
],
"type": [
"null",
"object"
]
},
"market_snapshot": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"change_pct": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"price": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"volume_24h": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"available"
],
"type": [
"null",
"object"
]
},
"orderbook": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"count": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"available",
"total",
"count"
],
"type": [
"null",
"object"
]
},
"social": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"mention_count": {
"type": "integer"
},
"sentiment_label": {
"type": "string"
},
"ugc_available": {
"type": "boolean"
},
"ugc_used": {
"type": "boolean"
},
"x_available": {
"type": "boolean"
}
},
"required": [
"x_available",
"ugc_available",
"ugc_used",
"mention_count"
],
"type": [
"null",
"object"
]
},
"technical_analysis": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"signal": {
"type": "string"
}
},
"required": [
"available"
],
"type": [
"null",
"object"
]
}
},
"type": [
"null",
"object"
]
},
"generated_at": {
"description": "Report generation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"price_change_pct": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"report_id": {
"type": "string"
},
"report_info": {
"description": "Market-move attribution report in Markdown; null when unavailable or pending.",
"type": [
"null",
"string"
]
},
"report_status": {
"description": "completed, pending, failed, or not_found.",
"type": "string"
},
"source_type": {
"description": "nullable",
"type": [
"null",
"integer"
]
},
"storage_error": {
"type": "string"
},
"storage_status": {
"type": "string"
},
"summary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"symbol": {
"type": "string"
},
"title": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"trigger_label": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"updated_at": {
"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.",
"type": [
"null",
"string"
]
},
"window_end": {
"description": "Analysis-window end in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"window_end_utc8": {
"description": "Analysis-window end converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.",
"type": [
"null",
"string"
]
},
"window_start": {
"description": "Analysis-window start in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"window_start_utc8": {
"description": "Analysis-window start converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.",
"type": [
"null",
"string"
]
},
"z_price": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"z_price_threshold": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"report_id",
"event_id",
"candidate_type",
"symbol",
"report_status"
],
"additionalProperties": false
}🟢news_events_list_market_move_reports(symbol, start_time, end_time, limit)
[Read] List stored market-move attribution reports for one symbol, filtering by an inclusive UTC0 updated_at range and sorting results by event_time descending. Reports may be updated after their market event, so updated_at can be later than event_time. Timezone-less inputs are UTC0; inputs with an explicit offset are converted to UTC0 before the read-only service-ai-pe query. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Required cryptocurrency symbol, for example ETH; 1-20 characters and normalized to uppercase."
},
"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."
},
"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."
},
"limit": {
"type": "integer",
"description": "Maximum reports to return; omitted or 0 defaults to 20, otherwise allowed range is 1-100."
}
},
"required": [
"symbol",
"start_time",
"end_time"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"duration_ms": {
"type": "integer"
},
"reports": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"absolute_change_threshold": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"candidate_type": {
"type": "string"
},
"created_at": {
"description": "Report creation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"direction": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"display_expire_time": {
"description": "Report display-expiration time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"duration_ms": {
"description": "MCP-to-service-ai-pe call duration; populated by get_market_move_report.",
"type": "integer"
},
"event_id": {
"type": "string"
},
"event_time": {
"description": "Market-move event time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"evidence": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"coin_info": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"match_count": {
"type": "integer"
}
},
"required": [
"available",
"match_count"
],
"type": [
"null",
"object"
]
},
"explain_market_move": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"latest_news_count": {
"type": "integer"
},
"sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"summary": {
"type": "string"
},
"summary_available": {
"type": "boolean"
},
"supporting_events": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"supporting_events_count": {
"type": "integer"
}
},
"required": [
"summary_available",
"latest_news_count",
"supporting_events_count",
"sources",
"supporting_events"
],
"type": [
"null",
"object"
]
},
"market_snapshot": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"change_pct": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"price": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"volume_24h": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"available"
],
"type": [
"null",
"object"
]
},
"orderbook": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"count": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"available",
"total",
"count"
],
"type": [
"null",
"object"
]
},
"social": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"mention_count": {
"type": "integer"
},
"sentiment_label": {
"type": "string"
},
"ugc_available": {
"type": "boolean"
},
"ugc_used": {
"type": "boolean"
},
"x_available": {
"type": "boolean"
}
},
"required": [
"x_available",
"ugc_available",
"ugc_used",
"mention_count"
],
"type": [
"null",
"object"
]
},
"technical_analysis": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"available": {
"type": "boolean"
},
"signal": {
"type": "string"
}
},
"required": [
"available"
],
"type": [
"null",
"object"
]
}
},
"type": [
"null",
"object"
]
},
"generated_at": {
"description": "Report generation time in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"price_change_pct": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"report_id": {
"type": "string"
},
"report_info": {
"description": "Market-move attribution report in Markdown; null when unavailable or pending.",
"type": [
"null",
"string"
]
},
"report_status": {
"description": "completed, pending, failed, or not_found.",
"type": "string"
},
"source_type": {
"description": "nullable",
"type": [
"null",
"integer"
]
},
"storage_error": {
"type": "string"
},
"storage_status": {
"type": "string"
},
"summary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"symbol": {
"type": "string"
},
"title": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"trigger_label": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"updated_at": {
"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.",
"type": [
"null",
"string"
]
},
"window_end": {
"description": "Analysis-window end in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"window_end_utc8": {
"description": "Analysis-window end converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.",
"type": [
"null",
"string"
]
},
"window_start": {
"description": "Analysis-window start in UTC0, formatted as YYYY-MM-DD HH:MM:SS without a timezone suffix.",
"type": [
"null",
"string"
]
},
"window_start_utc8": {
"description": "Analysis-window start converted from UTC0 to UTC+8, returned with an explicit +08:00 offset.",
"type": [
"null",
"string"
]
},
"z_price": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"z_price_threshold": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"report_id",
"event_id",
"candidate_type",
"symbol",
"report_status"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"status": {
"description": "ready, generating, not_found, or failed.",
"type": "string"
},
"trace_id": {
"type": "string"
}
},
"required": [
"status",
"reports",
"trace_id",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_get_exchange_announcements(exchange, platform, query, coin, announcement_type, ...)
[Read] Venue-published exchange notices: listings, delistings, maintenance. Media rumors or general crypto headlines -> search_news. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"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."
},
"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."
},
"coin": {
"type": "string",
"description": "Comma-separated tickers; omit if empty."
},
"announcement_type": {
"type": "string",
"description": "listing / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter)."
},
"limit": {
"type": "integer",
"description": "Max rows; omit if unset or <= 0; cap 100 when set."
},
"from": {
"type": "integer",
"description": "Window start Unix sec; omit if <= 0; MCP also filters locally after fetch."
},
"to": {
"type": "integer",
"description": "Window end Unix sec inclusive; forwarded downstream and filtered locally."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"announcement_type": {
"type": "string"
},
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"duration_ms": {
"type": "integer"
},
"exchange": {
"type": "string"
},
"from": {
"type": "integer"
},
"items": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"limit": {
"type": "integer"
},
"platform": {
"type": "string"
},
"query": {
"type": "string"
},
"to": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_get_hot_topics(coin, window, limit, platforms)
[Read] Get the top 2-4 social discussion themes for one coin over the latest 4h, including direction, influence, sentiment, platforms, and representative evidence posts. For arbitrary social search use search_ugc; for X/Twitter-only narrative research use search_x. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"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."
},
"window": {
"type": "string",
"description": "Aggregation window. Only 4h is currently supported; default 4h."
},
"limit": {
"type": "integer",
"description": "Number of hot topics to return. Default 4; allowed range 2 to 4."
},
"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."
}
},
"required": [
"coin"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"generated_at": {
"description": "Upstream generation time as Unix seconds.",
"type": "integer"
},
"hide_reason": {
"description": "no_data or insufficient_evidence when topics should be hidden; null when displayable.",
"type": [
"null",
"string"
]
},
"topics": {
"description": "Two to four qualified topics, or an empty array when evidence is insufficient.",
"items": {
"additionalProperties": false,
"properties": {
"direction": {
"description": "up, down, or neutral.",
"type": "string"
},
"engagement_sum": {
"type": "number"
},
"evidence_posts": {
"items": {
"additionalProperties": false,
"properties": {
"author_name": {
"type": "string"
},
"clean_text": {
"type": "string"
},
"engagement_count": {
"type": "integer"
},
"platform": {
"type": "string"
},
"post_id": {
"type": "string"
},
"single_post_summary_zh": {
"type": "string"
}
},
"required": [
"post_id",
"platform"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"platforms": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"post_count": {
"type": "integer"
},
"sentiment_score": {
"description": "Average topic sentiment; null when unavailable.",
"type": [
"null",
"number"
]
},
"summary": {
"type": "string"
},
"topic_id": {
"type": "string"
},
"topic_influence_score": {
"description": "Topic influence score from 0 to 100.",
"type": "number"
},
"topic_key": {
"type": "string"
},
"topic_titles": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
}
},
"required": [
"topic_id",
"topic_key",
"topic_titles",
"direction",
"summary",
"platforms",
"post_count",
"engagement_sum",
"topic_influence_score",
"sentiment_score",
"evidence_posts"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"trace_id": {
"type": "string"
},
"window": {
"type": "string"
}
},
"required": [
"coin",
"window",
"topics",
"generated_at",
"hide_reason",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_get_mention_burst(coin, window, platforms)
[Read] Get a coin's 24h multi-platform social mention burst signal, growth, sentiment direction, platform breakdown, and display eligibility. For general sentiment ratios and sample tweets use get_social_sentiment; for individual social discussions use search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"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."
}
},
"required": [
"coin"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"current_mention_count": {
"type": "integer"
},
"current_weighted_mention_count": {
"type": "number"
},
"display_color": {
"description": "Display color generated by the upstream service: red, green, or neutral.",
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"evidence_summary": {
"description": "Human-readable evidence summary; null when unavailable.",
"type": [
"null",
"string"
]
},
"growth_rate": {
"description": "Weighted mention growth versus the previous 24h; null when no baseline exists.",
"type": [
"null",
"number"
]
},
"hide_reason": {
"description": "Why the signal should be hidden: no_data, insufficient_baseline, insufficient_sample, or not_burst; null when displayable.",
"type": [
"null",
"string"
]
},
"is_burst": {
"description": "True when the upstream burst thresholds for baseline, sample size, and growth are all met.",
"type": "boolean"
},
"platform_breakdown": {
"items": {
"additionalProperties": false,
"properties": {
"current_mention_count": {
"type": "integer"
},
"current_weighted_mention_count": {
"type": "number"
},
"growth_rate": {
"description": "Weighted mention growth versus the previous window; null when no baseline exists.",
"type": [
"null",
"number"
]
},
"platform": {
"type": "string"
},
"previous_mention_count": {
"type": "integer"
},
"previous_weighted_mention_count": {
"type": "number"
},
"sentiment_score": {
"description": "Platform sentiment score; null when unavailable.",
"type": [
"null",
"number"
]
}
},
"required": [
"platform",
"current_mention_count",
"previous_mention_count",
"current_weighted_mention_count",
"previous_weighted_mention_count",
"growth_rate",
"sentiment_score"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"previous_mention_count": {
"type": "integer"
},
"previous_weighted_mention_count": {
"type": "number"
},
"sentiment_direction": {
"description": "bullish, bearish, or neutral.",
"type": "string"
},
"trace_id": {
"type": "string"
},
"window": {
"type": "string"
}
},
"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"
],
"additionalProperties": false
}🟢news_feed_get_social_sentiment(coin, time_range)
[Read] Aggregate per-coin social sentiment for a time range: overall sentiment, positive/negative split, mention count, and sample tweets. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"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
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"mention_count": {
"type": "integer"
},
"overall_sentiment": {
"type": "number"
},
"sentiment_distribution": {
"additionalProperties": false,
"properties": {
"negative_count": {
"type": "integer"
},
"negative_ratio": {
"type": "number"
},
"neutral_count": {
"type": "integer"
},
"neutral_ratio": {
"type": "number"
},
"positive_count": {
"type": "integer"
},
"positive_ratio": {
"type": "number"
}
},
"required": [
"positive_ratio",
"negative_ratio",
"neutral_ratio"
],
"type": [
"null",
"object"
]
},
"sentiment_label": {
"type": "string"
},
"sentiment_label_raw": {
"type": "string"
},
"time_range": {
"type": "string"
},
"top_tweets": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"overall_sentiment",
"sentiment_label",
"mention_count",
"sentiment_distribution",
"top_tweets",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_search_news(query, coin, platform, platform_type, lang, ...)
[Read] Search the platform news index for headlines, news items, and briefing-style result lists. Open-web research with synthesized answers and cited external pages -> web_search. Event catalog with event_id -> get_latest_events. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"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)."
},
"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)."
},
"platform": {
"type": "string",
"description": "Source platform name for API platform (e.g. panews, theblock)."
},
"platform_type": {
"type": "string",
"description": "Legacy: maps to API platform when platform is omitted; omit platform when value is all."
},
"lang": {
"type": "string",
"description": "MCP-only filter on metadata.lang or top-level lang; not sent to upstream API."
},
"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."
},
"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."
},
"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."
},
"sort_by": {
"type": "string",
"description": "e.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort."
},
"top_total_score": {
"type": [
"null",
"integer"
],
"description": "Only when query empty (0 or 1); non-empty query forces similarity mode."
},
"limit": {
"type": "integer",
"description": "Page size mapped to API page_size; default 10, max 100."
},
"page": {
"type": "integer",
"description": "Page number mapped to API page; default 1."
},
"similarity_score": {
"type": "string",
"description": "Similarity threshold; default 0.6 when query set; when query empty only sent if explicitly set."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"duration_ms": {
"type": "integer"
},
"end_time": {
"type": "string"
},
"from": {
"type": "integer"
},
"items": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"lang": {
"type": "string"
},
"limit": {
"type": "integer"
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"platform": {
"type": "string"
},
"platform_type": {
"type": "string"
},
"query": {
"type": "string"
},
"similarity_score": {
"type": "string"
},
"sort_by": {
"type": "string"
},
"start_time": {
"type": "string"
},
"time_range": {
"type": "string"
},
"to": {
"type": "integer"
},
"top_total_score": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"from",
"to",
"top_total_score",
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_search_ugc(query, coin, platform, domain, channel, ...)
[Read] Reddit/Discord/Telegram/YouTube-style UGC: non-empty query uses vector API; coin without query uses OpenSearch. Both empty invalid. X/Twitter narrative -> search_x; headlines -> search_news. Not macro economic statistics; not structured event list -> get_latest_events. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional NL query; non-empty uses vector search. May combine with coin; both empty is invalid."
},
"coin": {
"type": "string",
"description": "Ticker filter; with query filters results; without query required with index for OpenSearch list mode."
},
"platform": {
"type": "string",
"description": "reddit / discord / telegram / youtube / all (default all)."
},
"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."
},
"quality_tier": {
"type": "string",
"description": "A (default, high quality) / B / all."
},
"time_range": {
"type": "string",
"description": "1h / 24h / 7d (default) / 30d / all."
},
"sort_by": {
"type": "string",
"description": "relevance (default) / upvotes / recent."
},
"limit": {
"type": "integer",
"description": "Max items; default 10, max 50."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"channel": {
"type": "string"
},
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"domain": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"items": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"limit": {
"type": "integer"
},
"platform": {
"type": "string"
},
"quality_tier": {
"type": "string"
},
"query": {
"type": "string"
},
"sort_by": {
"type": "string"
},
"time_range": {
"type": "string"
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_search_x(query, time_range, days, allowed_handles, excluded_handles, ...)
[Read] Search and analyze X/Twitter discussions for a topic, with tweet-level evidence and cited posts. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"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."
},
"days": {
"type": "integer",
"description": "Lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly 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."
},
"model": {
"type": "string",
"description": "Override configured Grok model id."
},
"enable_image_understanding": {
"type": "boolean",
"description": "Analyze images in posts."
},
"enable_video_understanding": {
"type": "boolean",
"description": "Analyze video in posts."
},
"lang": {
"type": "string",
"description": "Answer language: zh (default) / en / auto."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"allowed_handles": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"cited_tweets": {
"description": "xAI: tweet-level evidence and cited posts; fields depend on model and citations.",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"type": "string"
},
"content": {
"type": "string"
},
"likes": {
"type": "integer"
},
"reposts": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"author",
"content",
"url",
"likes",
"reposts"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"content": {
"description": "Same as summary for legacy clients; tweet-level X/Twitter evidence—not headline index (search_news).",
"type": "string"
},
"count": {
"type": "integer"
},
"days": {
"type": "integer"
},
"disclaimer": {
"description": "Fixed disclaimer on successful xAI response.",
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"excluded_handles": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"from_date": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"key_points": {
"description": "xAI: bullet points from cited posts; empty array if none. Not briefing-style platform news lists (search_news).",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lang": {
"type": "string"
},
"model": {
"type": "string"
},
"query": {
"type": "string"
},
"sentiment_label": {
"description": "xAI: bullish / bearish / neutral for the discussion; empty if unknown. Not per-coin sentiment label KPIs (get_social_sentiment).",
"type": "string"
},
"sentiment_score": {
"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).",
"type": [
"null",
"integer"
]
},
"source": {
"type": "string"
},
"summary": {
"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).",
"type": "string"
},
"to_date": {
"type": "string"
},
"total": {
"type": "integer"
}
},
"required": [
"summary",
"content",
"sentiment_label",
"key_points",
"cited_tweets",
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_feed_web_search(query, coin, mode, time_range, lang, ...)
[Read] Search the open web and return a synthesized answer with cited external pages. Built-in headline lookup, news-item search, or briefing-style news list -> search_news. X/Twitter-only discussion or tweet evidence -> search_x. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"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)."
},
"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)."
},
"mode": {
"type": "string",
"description": "Answer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD)."
},
"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)."
},
"lang": {
"type": "string",
"description": "Answer language: zh (default) / en / auto."
},
"limit": {
"type": "integer",
"description": "Max cited external pages in the answer; default 5, max 10."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"cited_sources": {
"items": {
"additionalProperties": false,
"properties": {
"publish_time": {
"type": "string"
},
"snippet": {
"type": "string"
},
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"source",
"publish_time",
"snippet"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"disclaimer": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"items": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"key_points": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lang": {
"type": "string"
},
"mode": {
"type": "string"
},
"model": {
"type": "string"
},
"query": {
"type": "string"
},
"source": {
"type": "string"
},
"summary": {
"type": "string"
},
"time_range": {
"type": "string"
},
"total": {
"type": "integer"
}
},
"required": [
"summary",
"key_points",
"cited_sources",
"total",
"count",
"items",
"duration_ms"
],
"additionalProperties": false
}🟢news_prediction_get_event_signal(event_ref, window, venue, include_markets, include_orderbook_summary)
[Read] Single event signal from dws_external_event_signal_hf by event_ref (venue:venue_event_id). window 1h/24h/7d (default 24h). Returns outcome_probabilities, volume_flow, directional_context, optional markets[] (default include_markets=true). depth_summary always null—use get_market_orderbook for live depth. daily_ranking when rank index configured. Discover event_ref -> search_events. include_orderbook_summary ignored. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"event_ref": {
"type": "string",
"description": "Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events."
},
"window": {
"type": "string",
"description": "Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive)."
},
"venue": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional; each non-empty value must equal event_ref venue or invalid_param."
},
"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."
}
},
"required": [
"event_ref"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"cross_venue_divergence": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"daily_ranking": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"daily_rank_by_venue": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"fastest_rising": {
"description": "nullable",
"type": [
"null",
"integer"
]
},
"volume_delta": {
"description": "nullable",
"type": [
"null",
"integer"
]
}
},
"type": "object"
},
"type": "object"
},
"probability_delta_today": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"type": [
"null",
"object"
]
},
"depth_summary": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"best_no_ask": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_no_bid": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_yes_ask": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_yes_bid": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"spread_yes": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"type": [
"null",
"object"
]
},
"directional_context": {
"additionalProperties": true,
"type": "object"
},
"duration_ms": {
"type": "integer"
},
"event_identity": {
"additionalProperties": false,
"properties": {
"category_ai_primary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"event_ref": {
"type": "string"
},
"market_count": {
"type": "integer"
},
"status_tags": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"venue_event_title": {
"type": "string"
}
},
"required": [
"event_ref",
"venue",
"venue_event_id",
"venue_event_title",
"status_tags",
"market_count"
],
"type": "object"
},
"markets": {
"items": {
"additionalProperties": false,
"properties": {
"is_lead_market": {
"type": "boolean"
},
"liquidity_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"market_category_ai_primary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_status": {
"type": "string"
},
"market_title": {
"type": "string"
},
"mid_yes_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"price_bar_time": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"probability_change_6h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"venue_market_id": {
"type": "string"
},
"volume_24h_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"volume_total_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"venue_market_id",
"market_title",
"is_lead_market"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"outcome_probabilities": {
"additionalProperties": false,
"properties": {
"no_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_change_1h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_change_24h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_change_6h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"yes_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"type": "object"
},
"partial": {
"type": "boolean"
},
"signal_time": {
"type": "string"
},
"source_data_status": {
"type": "string"
},
"volume_flow": {
"additionalProperties": false,
"properties": {
"source": {
"type": "string"
},
"total_liquidity_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"total_volume_usd_24h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"source"
],
"type": "object"
},
"window": {
"type": "string"
}
},
"required": [
"partial",
"missing_sources",
"event_identity",
"signal_time",
"source_data_status",
"outcome_probabilities",
"depth_summary",
"volume_flow",
"directional_context",
"duration_ms"
],
"additionalProperties": false
}🟢news_prediction_get_fastest_rising_ranking(date_utc, limit, venue, category, status)
[Read] Daily venue/overall ranking by probability rise (UTC rank_date). Optional venue[], category, status (same as volume_delta ranking). Drops rows missing open_mid_probability_utc or probability_delta_today. Requires predictionRankIndex. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"date_utc": {
"type": "string",
"description": "UTC date in YYYY-MM-DD. Defaults to today_utc."
},
"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."
},
"category": {
"type": "string",
"description": "Optional category filter: exact term on rank index field category; omit or all to disable."
},
"status": {
"type": "string",
"description": "Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"by_venue": {
"additionalProperties": {
"items": {
"additionalProperties": false,
"properties": {
"event_name": {
"type": "string"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"latest_mid_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"lead_market_id": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_name": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"open_mid_probability_utc": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_delta_today": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"rank_no": {
"type": "integer"
},
"source_data_status": {
"type": "string"
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"rank_no",
"venue",
"venue_event_id",
"event_name",
"source_data_status",
"excluded_reasons"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"type": "object"
},
"duration_ms": {
"type": "integer"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"generated_at": {
"type": "string"
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"overall": {
"items": {
"additionalProperties": false,
"properties": {
"event_name": {
"type": "string"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"latest_mid_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"lead_market_id": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_name": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"open_mid_probability_utc": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_delta_today": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"rank_no": {
"type": "integer"
},
"source_data_status": {
"type": "string"
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"rank_no",
"venue",
"venue_event_id",
"event_name",
"source_data_status",
"excluded_reasons"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"partial": {
"type": "boolean"
},
"rank_date_utc": {
"type": "string"
},
"source_data_status": {
"type": "string"
}
},
"required": [
"partial",
"missing_sources",
"rank_date_utc",
"generated_at",
"overall",
"by_venue",
"excluded_reasons",
"source_data_status",
"duration_ms"
],
"additionalProperties": false
}🟢news_prediction_get_market_orderbook(venue, market_id, depth, mode, granularity, ...)
[Read] Live current order book only (mode=current). depth 1-20 (default 20). polymarket: market_id=venue_market_id; needs opensearch.predictionMarketIndex for token lookup (else not_implemented); yes/no CLOB /book in parallel—partial if one side fails, tool error only if both fail. predict_fun: official numeric market_id (not polymarket ids); needs predictFunAPIKey—empty/missing config returns partial_not_configured (no HTTP); API/parse errors return partial (not internal); 404 resource_not_found. Rejects history/granularity/time/page_token. snapshot_time/book_levels/best_* may be null when partial. Event list/signal -> search_events / get_event_signal. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"venue": {
"type": "string",
"description": "Required. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error)."
},
"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."
},
"depth": {
"type": [
"null",
"integer"
],
"description": "yes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param."
},
"mode": {
"type": "string",
"description": "Empty or current only (default current). history and other values rejected."
},
"granularity": {
"type": "string",
"description": "Unsupported; if set, request is rejected."
},
"start_time": {
"type": "string",
"description": "Unsupported; if set, request is rejected."
},
"end_time": {
"type": "string",
"description": "Unsupported; if set, request is rejected."
},
"page_token": {
"type": "string",
"description": "Unsupported; if set, request is rejected."
}
},
"required": [
"venue",
"market_id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"book_levels": {
"additionalProperties": false,
"description": "nullable",
"properties": {
"best_no_ask": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_no_bid": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_yes_ask": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"best_yes_bid": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"spread_no": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"spread_yes": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"top5_depth_ask_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"top5_depth_bid_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"yes_asks": {
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"yes_bids": {
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"yes_bids",
"yes_asks"
],
"type": [
"null",
"object"
]
},
"duration_ms": {
"type": "integer"
},
"market_id": {
"type": "string"
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"mode": {
"type": "string"
},
"partial": {
"type": "boolean"
},
"snapshot_time": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"source_api": {
"type": "string"
},
"source_data_status": {
"type": "string"
},
"venue": {
"type": "string"
}
},
"required": [
"partial",
"missing_sources",
"venue",
"market_id",
"source_api",
"mode",
"snapshot_time",
"book_levels",
"source_data_status",
"duration_ms"
],
"additionalProperties": false
}🟢news_prediction_get_volume_delta_ranking(date_utc, limit, venue, category, status)
[Read] Daily venue/overall ranking by volume delta (UTC rank_date). Optional venue[], category (exact term on rank index), status (active/closed/resolved/all; default active). Requires opensearch.predictionRankIndex. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"date_utc": {
"type": "string",
"description": "UTC date in YYYY-MM-DD. Defaults to today_utc."
},
"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."
},
"category": {
"type": "string",
"description": "Optional category filter: exact term on rank index field category; omit or all to disable."
},
"status": {
"type": "string",
"description": "Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"by_venue": {
"additionalProperties": {
"items": {
"additionalProperties": false,
"properties": {
"event_name": {
"type": "string"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"latest_mid_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"lead_market_id": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_name": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"open_mid_probability_utc": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_delta_today": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"rank_no": {
"type": "integer"
},
"source_data_status": {
"type": "string"
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"rank_no",
"venue",
"venue_event_id",
"event_name",
"source_data_status",
"excluded_reasons"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"type": "object"
},
"duration_ms": {
"type": "integer"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"generated_at": {
"type": "string"
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"overall": {
"items": {
"additionalProperties": false,
"properties": {
"event_name": {
"type": "string"
},
"excluded_reasons": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"latest_mid_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"lead_market_id": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_name": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"open_mid_probability_utc": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"probability_delta_today": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"rank_no": {
"type": "integer"
},
"source_data_status": {
"type": "string"
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"volume_delta_usd_today": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"rank_no",
"venue",
"venue_event_id",
"event_name",
"source_data_status",
"excluded_reasons"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"partial": {
"type": "boolean"
},
"rank_date_utc": {
"type": "string"
},
"source_data_status": {
"type": "string"
}
},
"required": [
"partial",
"missing_sources",
"rank_date_utc",
"generated_at",
"overall",
"by_venue",
"excluded_reasons",
"source_data_status",
"duration_ms"
],
"additionalProperties": false
}🟢news_prediction_search_events(query, coin, category, status, venue, ...)
[Read] Search prediction events on opensearch.predictionEventSignalIndex (dws_prediction_event_signal_hf alias, hourly UNIQUE part_hour+venue+venue_event_id). query/coin/category optional; coin-only unsupported_filter. status filters event_status; status_tags from status_json_array. sort recently_listed uses create_time (first_seen); volume_delta_today uses total_volume_usd_24h (no volume_delta column). category filter: event_category_primary or lead_market_category_primary; excludes empty event_category_primary. Collapse venue_event_id. with_markets: source_markets_json or predictionMarketIndex. Detail -> get_event_signal (external); orderbook -> get_market_orderbook. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional full-text query; all of query, coin, category are optional."
},
"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)."
},
"category": {
"type": "string",
"description": "Optional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary."
},
"status": {
"type": "string",
"description": "Filter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array."
},
"venue": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Optional venue filter. Allowed: polymarket, predict_fun."
},
"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)."
},
"limit": {
"type": [
"null",
"integer"
],
"description": "Page size; default 20, max 100."
},
"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
}Output Schema
{
"type": "object",
"properties": {
"coin_filter_mode": {
"type": "string"
},
"duration_ms": {
"type": "integer"
},
"effective_sort_by": {
"description": "Actual sort applied (equals sort_by unless ES sort fallback).",
"type": "string"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"attention_score": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"category_ai_primary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"event_ref": {
"type": "string"
},
"lead_market_id": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"lead_yes_probability": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"market_category_ai_primary": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"market_count": {
"type": "integer"
},
"markets": {
"items": {
"additionalProperties": false,
"properties": {
"liquidity_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"market_category_primary": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"market_status": {
"type": "string"
},
"market_title": {
"type": "string"
},
"venue_market_id": {
"type": "string"
},
"volume_24h_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
}
},
"required": [
"venue_market_id",
"market_title"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"status_tags": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"total_liquidity_usd": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"total_volume_usd_24h": {
"description": "nullable",
"type": [
"null",
"number"
]
},
"venue": {
"type": "string"
},
"venue_event_id": {
"type": "string"
},
"venue_event_title": {
"type": "string"
}
},
"required": [
"event_ref",
"venue",
"venue_event_id",
"venue_event_title",
"status_tags",
"market_count"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"missing_sources": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"next_page_token": {
"description": "nullable",
"type": [
"null",
"string"
]
},
"partial": {
"type": "boolean"
}
},
"required": [
"partial",
"events",
"duration_ms"
],
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded18 tools
verifiedversion not recorded18 tools