Gate News MCP
Gate news MCP for crypto news, structured events, announcements, and social sentiment.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (8)
- LOWTool 'news_events_explain_market_move' name length outside 3-30 rangeen news_events_explain_market_move
- LOWTool 'news_events_get_market_move_report' name length outside 3-30 rangeen news_events_get_market_move_report
- LOWTool 'news_events_list_market_move_reports' name length outside 3-30 rangeen news_events_list_market_move_reports
- LOWTool 'news_feed_get_exchange_announcements' name length outside 3-30 rangeen news_feed_get_exchange_announcements
- LOWTool 'news_prediction_get_event_signal' name length outside 3-30 rangeen news_prediction_get_event_signal
- LOWTool 'news_prediction_get_fastest_rising_ranking' name length outside 3-30 rangeen news_prediction_get_fastest_rising_ranking
- LOWTool 'news_prediction_get_market_orderbook' name length outside 3-30 rangeen news_prediction_get_market_orderbook
- LOWTool 'news_prediction_get_volume_delta_ranking' name length outside 3-30 rangeen news_prediction_get_volume_delta_ranking
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~13,788Tokens (definiciones de herramientas)
~8.4 KBTamaño de respuesta típico
Impacto significativo en la atención (10.77% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"gate-news": {
"url": "https://api.gatemcp.ai/mcp/news"
}
}
}Puntos de conexión remotos
https://api.gatemcp.ai/mcp/newsstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (18)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada18 herramientas
verificadoversión no registrada18 herramientas