Gate News MCP
REMOTE · API.GATEMCP.AI · SCANNED AUG 3
Gate news MCP for crypto news, structured events, announcements, and social sentiment.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security74
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability31
- AI-judged instruction clarity (fair).Partial
- Context-footprint check failed: tool/resource definitions use about 4803 tokens (~266/item across 18 items; 18 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · api.gatemcp.ai
claude mcp add --transport http gateio-dev-gate-news https://api.gatemcp.ai/mcp/news
[mcp_servers.gateio-dev-gate-news] url = "https://api.gatemcp.ai/mcp/news"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"gateio-dev-gate-news": {
"type": "remote",
"url": "https://api.gatemcp.ai/mcp/news",
"enabled": true
}
}
} openclaw mcp add gateio-dev-gate-news --url https://api.gatemcp.ai/mcp/news --transport streamable-http
mcp_servers:
gateio-dev-gate-news:
url: "https://api.gatemcp.ai/mcp/news" {
"mcpServers": {
"gateio-dev-gate-news": {
"type": "http",
"url": "https://api.gatemcp.ai/mcp/news"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +4
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 56
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://api.gatemcp.ai/mcp/news
TLS valid
Negotiated TLS 1.3 with TLS_AES_256_GCM_SHA384 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=api.gatemcp.ai | CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN | 1 Aug 2026 | 29 Oct 2026 | RSA 2048 | SHA256-RSA | 5b67f0c347846bf3451b522c6ab8381 |
| SANs: api.gatemcp.ai | ||||||
| CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 8 Jan 2025 | 7 Jan 2035 | RSA 4096 | SHA256-RSA | 926323b4964e368461512def1a5d52c |
| CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 1 Aug 2013 | 15 Jan 2038 | RSA 2048 | SHA256-RSA | 33af1e6a711a9a0bb2864b11d09fae5 |
DNSSEC insecure
Validation of api.gatemcp.ai. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| ai. | present | 3799 | 8 | Verified |
| gatemcp.ai. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| x-content-type-options | nosniff |
| x-frame-options | DENY |
| referrer-policy | strict-origin-when-cross-origin |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.gatemcp.ai/mcp/news | Verified | 200 | |
| http (plaintext) | http://api.gatemcp.ai/mcp/news | HTTPS enforced |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
news_events_explain_market_move ~186
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | Target coin, e.g. BTC, ETH. Required at the Tool layer. |
| lang | string | — | zh / en. Default zh. |
| mode | string | — | auto / price_move / event_impact. Default auto. |
| query | string | yes | User's original question, e.g. 'Why did BTC surge?' |
| time_range | string | — | Time window: 30m/1h/2h/4h/24h. Default 2h. |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | — |
| data_status | object | yes | — |
| duration_ms | integer | yes | — |
| latest_news | array | yes | — |
| query | string | yes | — |
| summary | string | yes | — |
| supporting_events | array | yes | — |
| time_range | string | yes | — |
No examples provided.
news_events_get_event_detail ~77
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| event_id | string | yes | Required event_id from get_latest_events items—opaque digest id, not a trading pair slug or headline hash. |
| Name | Type | Req | Description |
|---|---|---|---|
| community_reaction | string | — | — |
| content | string | — | — |
| direction | string | — | — |
| duration_ms | integer | yes | — |
| event_id | string | yes | — |
| impact_analysis | string | — | — |
| impact_direction | string | — | — |
| impact_direction_reason | string | — | — |
| news_coverage | string | — | — |
| occurred_at | string | — | — |
| strength | string | — | — |
| summary | string | — | — |
| symbols | array | — | — |
| title | string | — | — |
No examples provided.
news_events_get_latest_events ~302
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | Optional comma-separated tickers e.g. BTC,ETH for digest items; not the same as search_news tickers-only heat mode. |
| cursor | string | — | Optional pagination cursor. |
| direction | string | — | Optional filter on persisted impact_direction: positive / negative / neutral / mixed / unknown / all (default all, no filter). MCP does not re-judge direction. |
| end_time | string | — | Absolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range. |
| event_type | string | — | Optional filter on structured digest event_type. Not search_news headline similarity/heat. |
| limit | integer | — | Page size; default 20, max 100. |
| start_time | string | — | Absolute start (ISO8601 or Unix sec/ms). Mutually exclusive with time_range; pair with end_time or let server fill the other bound. |
| time_range | string | — | 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 macr… |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | — |
| count | integer | yes | — |
| direction | string | — | — |
| duration_ms | integer | yes | — |
| end_time | string | — | — |
| event_type | string | — | — |
| items | array | yes | — |
| limit | integer | yes | — |
| start_time | string | — | — |
| time_range | string | — | — |
| total | integer | yes | — |
No examples provided.
news_events_get_market_move_report ~163
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| event_id | string | — | Optional market-move event ID. When report_id and event_id are omitted, returns the latest report for symbol. |
| report_id | string | — | Optional report ID for an exact lookup. Takes priority over event_id when both are provided. |
| symbol | string | yes | Required cryptocurrency symbol, for example BTC or TAIKO; 1-20 characters and normalized to uppercase. |
| Name | Type | Req | Description |
|---|---|---|---|
| absolute_change_threshold | — | — | — |
| candidate_type | string | yes | — |
| created_at | — | — | — |
| direction | — | — | — |
| display_expire_time | — | — | — |
| duration_ms | integer | — | MCP-to-service-ai-pe call duration; populated by get_market_move_report. |
| event_id | string | yes | — |
| event_time | — | — | — |
| evidence | — | — | — |
| generated_at | — | — | — |
| price_change_pct | — | — | — |
| report_id | string | yes | — |
| report_info | — | — | — |
| report_status | string | yes | completed, pending, failed, or not_found. |
| source_type | — | — | — |
| storage_error | string | — | — |
| storage_status | string | — | — |
| summary | — | — | — |
| symbol | string | yes | — |
| title | — | — | — |
| trigger_label | — | — | — |
| updated_at | — | — | — |
| window_end | — | — | — |
| window_end_utc8 | — | — | — |
| window_start | — | — | — |
| window_start_utc8 | — | — | — |
| z_price | — | — | — |
| z_price_threshold | — | — | — |
No examples provided.
news_events_list_market_move_reports ~268
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_time | string | yes | 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… |
| limit | integer | — | Maximum reports to return; omitted or 0 defaults to 20, otherwise allowed range is 1-100. |
| start_time | string | yes | 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 b… |
| symbol | string | yes | Required cryptocurrency symbol, for example ETH; 1-20 characters and normalized to uppercase. |
| Name | Type | Req | Description |
|---|---|---|---|
| duration_ms | integer | yes | — |
| reports | array | yes | 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. |
| status | string | yes | ready, generating, not_found, or failed. |
| trace_id | string | yes | — |
No examples provided.
news_feed_get_exchange_announcements ~230
[Read] Venue-published exchange notices: listings, delistings, maintenance. Media rumors or general crypto headlines -> search_news.
| Name | Type | Req | Description |
|---|---|---|---|
| announcement_type | string | — | listing / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter). |
| coin | string | — | Comma-separated tickers; omit if empty. |
| exchange | string | — | Venue id for API platform; used when platform is empty; not merged with query. |
| from | integer | — | Window start Unix sec; omit if <= 0; MCP also filters locally after fetch. |
| limit | integer | — | Max rows; omit if unset or <= 0; cap 100 when set. |
| platform | string | — | URL param platform; wins over exchange; if empty falls back to exchange. |
| query | string | — | 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. |
| to | integer | — | Window end Unix sec inclusive; forwarded downstream and filtered locally. |
| Name | Type | Req | Description |
|---|---|---|---|
| announcement_type | string | — | — |
| coin | string | — | — |
| count | integer | yes | — |
| duration_ms | integer | yes | — |
| exchange | string | — | — |
| from | integer | — | — |
| items | array | yes | — |
| limit | integer | — | — |
| platform | string | — | — |
| query | string | — | — |
| to | integer | — | — |
| total | integer | yes | — |
No examples provided.
news_feed_get_hot_topics ~215
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | 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 w… |
| limit | integer | — | Number of hot topics to return. Default 4; allowed range 2 to 4. |
| platforms | string | — | Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform. |
| window | string | — | Aggregation window. Only 4h is currently supported; default 4h. |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | — |
| duration_ms | integer | yes | — |
| generated_at | integer | yes | Upstream generation time as Unix seconds. |
| hide_reason | — | yes | — |
| topics | array | yes | Two to four qualified topics, or an empty array when evidence is insufficient. |
| trace_id | string | — | — |
| window | string | yes | — |
No examples provided.
news_feed_get_mention_burst ~186
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | 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 w… |
| platforms | string | — | Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform. |
| window | string | — | Aggregation window. Only 24h is currently supported; default 24h. |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | yes | — |
| current_mention_count | integer | yes | — |
| current_weighted_mention_count | number | yes | — |
| display_color | string | yes | Display color generated by the upstream service: red, green, or neutral. |
| duration_ms | integer | yes | — |
| evidence_summary | — | yes | — |
| growth_rate | — | yes | — |
| hide_reason | — | yes | — |
| is_burst | boolean | yes | True when the upstream burst thresholds for baseline, sample size, and growth are all met. |
| platform_breakdown | array | yes | — |
| previous_mention_count | integer | yes | — |
| previous_weighted_mention_count | number | yes | — |
| sentiment_direction | string | yes | bullish, bearish, or neutral. |
| trace_id | string | — | — |
| window | string | yes | — |
No examples provided.
news_feed_get_social_sentiment ~175
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | 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 sear… |
| time_range | string | — | 1h / 24h (default) / 7d window for per-coin sentiment aggregation (overall sentiment, positive/negative split, mention count). |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | — |
| duration_ms | integer | yes | — |
| mention_count | integer | yes | — |
| overall_sentiment | number | yes | — |
| sentiment_distribution | object | yes | — |
| sentiment_label | string | yes | — |
| sentiment_label_raw | string | — | — |
| time_range | string | — | — |
| top_tweets | array | yes | — |
No examples provided.
news_feed_search_news ~540
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | 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 synthe… |
| end_time | string | — | End time mapped to API to (Unix sec). Ignored when time_range is set. End-only defaults start to 24h before end. |
| lang | string | — | MCP-only filter on metadata.lang or top-level lang; not sent to upstream API. |
| limit | integer | — | Page size mapped to API page_size; default 10, max 100. |
| page | integer | — | Page number mapped to API page; default 1. |
| platform | string | — | Source platform name for API platform (e.g. panews, theblock). |
| platform_type | string | — | Legacy: maps to API platform when platform is omitted; omit platform when value is all. |
| query | string | — | 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 r… |
| similarity_score | string | — | Similarity threshold; default 0.6 when query set; when query empty only sent if explicitly set. |
| sort_by | string | — | e.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort. |
| start_time | string | — | Start time (ISO8601 or Unix sec/ms) mapped to API from. Ignored when time_range is set. Start-only defaults end to now; both empty defaults last 7d when time_range is also empty. |
| time_range | string | — | 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… |
| top_total_score | integer | — | Only when query empty (0 or 1); non-empty query forces similarity mode. |
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | — |
| count | integer | yes | — |
| duration_ms | integer | yes | — |
| end_time | string | — | — |
| from | integer | yes | — |
| items | array | yes | — |
| lang | string | — | — |
| limit | integer | — | — |
| page | integer | — | — |
| page_size | integer | — | — |
| platform | string | — | — |
| platform_type | string | — | — |
| query | string | — | — |
| similarity_score | string | — | — |
| sort_by | string | — | — |
| start_time | string | — | — |
| time_range | string | — | — |
| to | integer | yes | — |
| top_total_score | integer | yes | — |
| total | integer | yes | — |
No examples provided.
news_feed_search_ugc ~299
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| channel | string | — | Optional source channel e.g. r/ethereum or handle. |
| coin | string | — | Ticker filter; with query filters results; without query required with index for OpenSearch list mode. |
| domain | string | — | 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)… |
| limit | integer | — | Max items; default 10, max 50. |
| platform | string | — | reddit / discord / telegram / youtube / all (default all). |
| quality_tier | string | — | A (default, high quality) / B / all. |
| query | string | — | Optional NL query; non-empty uses vector search. May combine with coin; both empty is invalid. |
| sort_by | string | — | relevance (default) / upvotes / recent. |
| time_range | string | — | 1h / 24h / 7d (default) / 30d / all. |
| Name | Type | Req | Description |
|---|---|---|---|
| channel | string | — | — |
| coin | string | — | — |
| count | integer | yes | — |
| domain | string | — | — |
| duration_ms | integer | yes | — |
| items | array | yes | — |
| limit | integer | — | — |
| platform | string | — | — |
| quality_tier | string | — | — |
| query | string | — | — |
| sort_by | string | — | — |
| time_range | string | — | — |
| total | integer | yes | — |
No examples provided.
news_feed_search_x ~512
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| allowed_handles | array | — | xAI only: include these X handles without @, max 10; mutually exclusive with excluded_handles. |
| coin | string | — | Platform fallback: maps to tickers for feed-style items when xAI path is unused—tweet-level X evidence remains the primary tool goal; per-coin sentiment KPIs -> get_social_sentiment. |
| days | integer | — | xAI only: lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly set. |
| enable_image_understanding | boolean | — | xAI only: analyze images in posts. |
| enable_video_understanding | boolean | — | xAI only: analyze video in posts. |
| end_time | string | — | Platform fallback: maps to to. |
| excluded_handles | array | — | xAI only: exclude these handles, max 10. |
| lang | string | — | Answer language: zh (default) / en / auto. Also used by platform fallback as MCP local lang filter. |
| limit | integer | — | Platform fallback: page_size, default 10. |
| model | string | — | xAI only: override configured Grok model id. |
| page | integer | — | Platform fallback: page number. |
| platform | string | — | Platform fallback: platform. |
| platform_type | string | — | Platform fallback: maps when platform omitted. |
| query | string | — | X/Twitter topic for tweet-level evidence and cited posts; English recommended. xAI: empty returns no results. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentimen… |
| similarity_score | string | — | Platform fallback: similarity threshold. |
| sort_by | string | — | Platform fallback: sort field. |
| start_time | string | — | Platform fallback: maps to from (Unix sec). |
| time_range | string | — | Preferred recency window for search_x: 1h / 24h (default) / 7d. Takes precedence over days when set. |
| top_total_score | integer | — | Platform fallback: heat vs similarity. |
| Name | Type | Req | Description |
|---|---|---|---|
| allowed_handles | array | — | — |
| cited_tweets | array | yes | xAI: tweet-level evidence and cited posts; fields depend on model and citations. |
| coin | string | — | — |
| content | string | yes | Same as summary for legacy clients; tweet-level X/Twitter evidence—not headline index (search_news). |
| count | integer | yes | — |
| days | integer | — | — |
| disclaimer | string | — | Fixed disclaimer on xAI success; empty on platform fallback. |
| duration_ms | integer | yes | — |
| excluded_handles | array | — | — |
| from_date | string | — | — |
| items | array | yes | — |
| key_points | array | yes | xAI: bullet points from cited posts; empty array if none. Not briefing-style platform news lists (search_news). |
| lang | string | — | — |
| model | string | — | — |
| platform | string | — | — |
| platform_type | string | — | — |
| query | string | — | — |
| sentiment_label | string | yes | xAI: bullish / bearish / neutral for the discussion; empty if unknown. Not per-coin sentiment label KPIs (get_social_sentiment). |
| sentiment_score | — | — | — |
| source | string | — | — |
| summary | string | yes | 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 sentimen… |
| to_date | string | — | — |
| total | integer | yes | — |
No examples provided.
news_feed_web_search ~277
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| coin | string | — | Optional ticker or project (e.g. BTC, ETH) to focus the open-web synthesized answer—not platform news index tickers (search_news). |
| lang | string | — | Answer language: zh (default) / en / auto. |
| limit | integer | — | Max cited external pages in the answer; default 5, max 10. |
| mode | string | — | Answer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD). |
| query | string | — | 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/Tw… |
| time_range | string | — | Recency window for open-web synthesis with cited external pages: 1h / 24h (default) / 7d / 30d. Not DeFi/TVL dashboard metrics (use platform-metrics tools). |
| Name | Type | Req | Description |
|---|---|---|---|
| cited_sources | array | yes | — |
| coin | string | — | — |
| count | integer | yes | — |
| disclaimer | string | — | — |
| duration_ms | integer | yes | — |
| items | array | yes | — |
| key_points | array | yes | — |
| lang | string | — | — |
| mode | string | — | — |
| model | string | — | — |
| query | string | — | — |
| source | string | — | — |
| summary | string | yes | — |
| time_range | string | — | — |
| total | integer | yes | — |
No examples provided.
news_prediction_get_event_signal ~254
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| event_ref | string | yes | Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events. |
| include_markets | boolean | — | Omitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex. |
| include_orderbook_summary | boolean | — | Deprecated and ignored; depth_summary is always null—use get_market_orderbook. |
| venue | array | — | Optional; each non-empty value must equal event_ref venue or invalid_param. |
| window | string | — | Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive). |
| Name | Type | Req | Description |
|---|---|---|---|
| cross_venue_divergence | — | — | — |
| daily_ranking | — | — | — |
| depth_summary | — | yes | — |
| directional_context | object | yes | — |
| duration_ms | integer | yes | — |
| event_identity | object | yes | — |
| markets | array | — | — |
| missing_sources | array | yes | — |
| outcome_probabilities | object | yes | — |
| partial | boolean | yes | — |
| signal_time | string | yes | — |
| source_data_status | string | yes | — |
| volume_flow | object | yes | — |
| window | string | — | — |
No examples provided.
news_prediction_get_fastest_rising_ranking ~169
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Optional category filter: exact term on rank index field category; omit or all to disable. |
| date_utc | string | — | UTC date in YYYY-MM-DD. Defaults to today_utc. |
| limit | integer | — | Page size; default 20, max 100. |
| status | string | — | Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active. |
| venue | array | — | Optional venue filter. Allowed: polymarket, predict_fun. |
| Name | Type | Req | Description |
|---|---|---|---|
| by_venue | object | yes | — |
| duration_ms | integer | yes | — |
| excluded_reasons | array | yes | — |
| generated_at | string | yes | — |
| missing_sources | array | yes | — |
| overall | array | yes | — |
| partial | boolean | yes | — |
| rank_date_utc | string | yes | — |
| source_data_status | string | yes | — |
No examples provided.
news_prediction_get_market_orderbook ~371
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | integer | — | yes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param. |
| end_time | string | — | Unsupported; if set, request is rejected. |
| granularity | string | — | Unsupported; if set, request is rejected. |
| market_id | string | yes | 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. |
| mode | string | — | Empty or current only (default current). history and other values rejected. |
| page_token | string | — | Unsupported; if set, request is rejected. |
| start_time | string | — | Unsupported; if set, request is rejected. |
| venue | string | yes | Required. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error). |
| Name | Type | Req | Description |
|---|---|---|---|
| book_levels | — | yes | — |
| duration_ms | integer | yes | — |
| market_id | string | yes | — |
| missing_sources | array | yes | — |
| mode | string | yes | — |
| partial | boolean | yes | — |
| snapshot_time | — | yes | — |
| source_api | string | yes | — |
| source_data_status | string | yes | — |
| venue | string | yes | — |
No examples provided.
news_prediction_get_volume_delta_ranking ~168
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Optional category filter: exact term on rank index field category; omit or all to disable. |
| date_utc | string | — | UTC date in YYYY-MM-DD. Defaults to today_utc. |
| limit | integer | — | Page size; default 20, max 100. |
| status | string | — | Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active. |
| venue | array | — | Optional venue filter. Allowed: polymarket, predict_fun. |
| Name | Type | Req | Description |
|---|---|---|---|
| by_venue | object | yes | — |
| duration_ms | integer | yes | — |
| excluded_reasons | array | yes | — |
| generated_at | string | yes | — |
| missing_sources | array | yes | — |
| overall | array | yes | — |
| partial | boolean | yes | — |
| rank_date_utc | string | yes | — |
| source_data_status | string | yes | — |
No examples provided.
news_prediction_search_events ~396
[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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Optional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary. |
| coin | string | — | Optional coin ticker; cannot be used alone without query or category (unsupported_filter). With query/category expands text recall only (best_effort). |
| limit | integer | — | Page size; default 20, max 100. |
| page_token | string | — | Base64URL page token from prior next_page_token; filters must match first page. |
| query | string | — | Optional full-text query; all of query, coin, category are optional. |
| sort_by | string | — | Sort key; default attention. Allowed: attention, volume, liquidity, recently_listed, probability_change, volume_delta_today (maps to total_volume_usd_24h on signal index). |
| status | string | — | Filter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array. |
| venue | array | — | Optional venue filter. Allowed: polymarket, predict_fun. |
| with_markets | boolean | — | When true, attach market summaries from source_markets_json or predictionMarketIndex. |
| Name | Type | Req | Description |
|---|---|---|---|
| coin_filter_mode | string | — | — |
| duration_ms | integer | yes | — |
| effective_sort_by | string | — | Actual sort applied (equals sort_by unless ES sort fallback). |
| events | array | yes | — |
| missing_sources | array | — | — |
| next_page_token | — | — | — |
| partial | boolean | yes | — |
No examples provided.