Gate News MCP

Working · 2.1 s

io.github.gateio-dev/gate-newsv0.1.0

Gate news MCP for crypto news, structured events, announcements, and social sentiment.

News & Media Crypto & Web3

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.gatemcp.ai/mcp/news

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

news_events_explain_market_move Read-only

[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.

coinstring, required

Target coin, e.g. BTC, ETH. Required at the Tool layer.

querystring, required

User's original question, e.g. 'Why did BTC surge?'

langstring

zh / en. Default zh.

modestring

auto / price_move / event_impact. Default auto.

time_rangestring

Time window: 30m/1h/2h/4h/24h. Default 2h.

Tools (18)

news_events_explain_market_move

read-only

Argument	Type	Description
coin*	string	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	User's original question, e.g. 'Why did BTC surge?'
time_range	string	Time window: 30m/1h/2h/4h/24h. Default 2h.

Input schema (JSON)

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

news_events_get_event_detail

[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.

read-only

Argument	Type	Description
event_id*	string	Required event_id from get_latest_events items—opaque digest id, not a trading pair slug or headline hash.

Input schema (JSON)

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

news_events_get_latest_events

[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.

read-only

Argument	Type	Description
coin	string	Optional comma-separated tickers e.g. BTC,ETH for digest items; not the same as search_news tickers-only heat mode.
limit	integer	Page size; default 20, max 100.
cursor	string	Optional pagination cursor.
end_time	string	Absolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range.
direction	string	Optional filter on persisted impact_direction: positive / negative / neutral / mixed / unknown / all (default all, no filter). MCP does not re-judge direction.
event_type	string	Optional filter on structured digest event_type. Not search_news headline similarity/heat.
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 macro indicator tools.

Input schema (JSON)

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

news_events_get_market_move_report

[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.

read-only

Argument	Type	Description
symbol*	string	Required cryptocurrency symbol, for example BTC or TAIKO; 1-20 characters and normalized to uppercase.
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.

Input schema (JSON)

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

news_events_list_market_move_reports

[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.

read-only

Argument	Type	Description
limit	integer	Maximum reports to return; omitted or 0 defaults to 20, otherwise allowed range is 1-100.
symbol*	string	Required cryptocurrency symbol, for example ETH; 1-20 characters and normalized to uppercase.
end_time*	string	Required inclusive upper bound for report updated_at in UTC0. Accepts ISO 8601 or YYYY-MM-DD HH:MM:SS; a value without a timezone is interpreted as UTC0, an explicit offset is converted to UTC0, and the value must not precede start_time.
start_time*	string	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.

Input schema (JSON)

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

news_feed_get_exchange_announcements

[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.

read-only

Argument	Type	Description
to	integer	Window end Unix sec inclusive; forwarded downstream and filtered locally.
coin	string	Comma-separated tickers; omit if empty.
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.
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.
exchange	string	Venue id for API platform; used when platform is empty; not merged with query.
platform	string	URL param platform; wins over exchange; if empty falls back to exchange.
announcement_type	string	listing / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter).

Input schema (JSON)

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

news_feed_get_hot_topics

[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.

read-only

Argument	Type	Description
coin*	string	Required non-empty cryptocurrency ticker, for example ETH. Leading and trailing whitespace is removed and the value is normalized to uppercase. Unknown or no-data tickers may return an empty result with hide_reason=no_data; no coin-dictionary validation is performed.
limit	integer	Number of hot topics to return. Default 4; allowed range 2 to 4.
window	string	Aggregation window. Only 4h is currently supported; default 4h.
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.

Input schema (JSON)

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

news_feed_get_mention_burst

[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.

read-only

Argument	Type	Description
coin*	string	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	string	Aggregation window. Only 24h is currently supported; default 24h.
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.

Input schema (JSON)

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

news_feed_get_social_sentiment

[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.

read-only

Argument	Type	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 search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc.
time_range	string	1h / 24h (default) / 7d window for per-coin sentiment aggregation (overall sentiment, positive/negative split, mention count).

Input schema (JSON)

{
  "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
}

news_feed_search_news

[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.

read-only

Argument	Type	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 synthesis (web_search).
lang	string	MCP-only filter on metadata.lang or top-level lang; not sent to upstream API.
page	integer	Page number mapped to API page; default 1.
limit	integer	Page size mapped to API page_size; default 10, max 100.
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 result lists—not open-web research with synthesized answers and cited external pages (web_search) or event catalog with event_id (get_latest_events).
sort_by	string	e.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort.
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.
platform	string	Source platform name for API platform (e.g. panews, theblock).
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_time or implicit last-7d when both are empty.
platform_type	string	Legacy: maps to API platform when platform is omitted; omit platform when value is all.
top_total_score	null \| integer	Only when query empty (0 or 1); non-empty query forces similarity mode.
similarity_score	string	Similarity threshold; default 0.6 when query set; when query empty only sent if explicitly set.

Input schema (JSON)

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

news_feed_search_ugc

[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.

read-only

Argument	Type	Description
coin	string	Ticker filter; with query filters results; without query required with index for OpenSearch list mode.
limit	integer	Max items; default 10, max 50.
query	string	Optional NL query; non-empty uses vector search. May combine with coin; both empty is invalid.
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) or get_latest_events.
channel	string	Optional source channel e.g. r/ethereum or handle.
sort_by	string	relevance (default) / upvotes / recent.
platform	string	reddit / discord / telegram / youtube / all (default all).
time_range	string	1h / 24h / 7d (default) / 30d / all.
quality_tier	string	A (default, high quality) / B / all.

Input schema (JSON)

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

news_feed_search_x

[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.

read-only

Argument	Type	Description
days	integer	Lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly set.
lang	string	Answer language: zh (default) / en / auto.
model	string	Override configured Grok model id.
query	string	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	string	Preferred recency window for search_x: 1h / 24h (default) / 7d. Takes precedence over days when set.
allowed_handles	null \| array	Include these X handles without @, max 10; mutually exclusive with excluded_handles.
excluded_handles	null \| array	Exclude these handles, max 10.
enable_image_understanding	boolean	Analyze images in posts.
enable_video_understanding	boolean	Analyze video in posts.

Input schema (JSON)

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

news_feed_web_search

[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.

read-only

Argument	Type	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.
mode	string	Answer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD).
limit	integer	Max cited external pages in the answer; default 5, max 10.
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/Twitter-only discussion or tweet-level evidence (search_x).
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).

Input schema (JSON)

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

news_prediction_get_event_signal

[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.

read-only

Argument	Type	Description
venue	null \| 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).
event_ref*	string	Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events.
include_markets	null \| 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.

Input schema (JSON)

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

news_prediction_get_fastest_rising_ranking

[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.

read-only

Argument	Type	Description
limit	null \| integer	Page size; default 20, max 100.
venue	null \| array	Optional venue filter. Allowed: polymarket, predict_fun.
status	string	Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
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.

Input schema (JSON)

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

news_prediction_get_market_orderbook

[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.

read-only

Argument	Type	Description
mode	string	Empty or current only (default current). history and other values rejected.
depth	null \| integer	yes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param.
venue*	string	Required. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error).
end_time	string	Unsupported; if set, request is rejected.
market_id*	string	Required. polymarket: venue_market_id in dws_prediction_market_hf (token lookup). predict_fun: official numeric id (e.g. 356640), not polymarket venue_market_id.
page_token	string	Unsupported; if set, request is rejected.
start_time	string	Unsupported; if set, request is rejected.
granularity	string	Unsupported; if set, request is rejected.

Input schema (JSON)

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

news_prediction_get_volume_delta_ranking

[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.

read-only

Argument	Type	Description
limit	null \| integer	Page size; default 20, max 100.
venue	null \| array	Optional venue filter. Allowed: polymarket, predict_fun.
status	string	Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
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.

Input schema (JSON)

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

news_prediction_search_events

[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.

read-only

Argument	Type	Description
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	null \| integer	Page size; default 20, max 100.
query	string	Optional full-text query; all of query, coin, category are optional.
venue	null \| array	Optional venue filter. Allowed: polymarket, predict_fun.
status	string	Filter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array.
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).
category	string	Optional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary.
page_token	string	Base64URL page token from prior next_page_token; filters must match first page.
with_markets	boolean	When true, attach market summaries from source_markets_json or predictionMarketIndex.

Input schema (JSON)

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