Okx Sentiment Tracker

okx news search

Full-text keyword search with optional filters.

okx news search --keyword <text>
               [--coins BTC,ETH] [--importance high|low]
               [--platform <source>]
               [--sentiment bullish|bearish|neutral]
               [--sort-by latest|relevant]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--after <cursor>] [--json]

--importance default is low (returns all news). Pass --importance high only for breaking / major news.

okx news detail

Get full article content by ID.

okx news detail <id>                  # news ID from previous result
               [--lang zh-CN|en-US] [--json]

okx news by-sentiment

Browse news filtered by sentiment (no keyword needed).

okx news by-sentiment --sentiment <bullish|bearish|neutral>
               [--coins BTC,ETH] [--importance high|low]
               [--sort-by latest|relevant]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--after <cursor>] [--json]

--importance default is low (returns all news). Pass --importance high only for breaking / major news.

okx news platforms

List available news platforms. Use the returned values with --platform on latest, by-coin, or search commands to filter by source.

okx news platforms [--json]

okx news coin-sentiment

Get current sentiment snapshot for specific coins.

okx news coin-sentiment --coins <BTC,ETH,...>
               [--period 1h|4h|24h]  # aggregation granularity, default 24h
               [--json]

Returns: symbol, label (bullish/bearish/neutral/mixed), bullishRatio, bearishRatio, mentionCount.

okx news coin-trend

Get time-series sentiment trend for a coin. Note: uses positional arg (not --coins).

okx news coin-trend <coin>            # positional arg, e.g. BTC
               [--period 1h|4h|24h]  # aggregation granularity, default 1h
               [--points 24]          # trend data points, default 24
               [--json]

trendPoints guide: 1h period → use 24 (last 24h), 4h → use 6, 24h → use 7.

okx news sentiment-rank

Get coin ranking by social hotness or sentiment direction.

okx news sentiment-rank [--period 1h|4h|24h]
               [--sort-by hot|bullish|bearish]  # hot=by mentions (default), bullish, bearish
               [--limit 10]                     # max 50
               [--json]

okx news economic-calendar

Get macro-economic calendar data. Historical data beyond 3 months requires VIP1+.

okx news economic-calendar [--region <country>] [--importance <1|2|3>]
                           [--before <ms>] [--after <ms>]
                           [--limit 100] [--json]

Rate limit: 1 request per 5 seconds (IP). Much stricter than other news commands.

before/after are inverted: --before <ts> = newer than ts (future), --after <ts> = older than ts (past). See Economic Calendar intent mapping for examples.

Common regions: united_states, china, euro_area, united_kingdom, japan, germany, canada, australia

Importance: 1=low, 2=medium, 3=high

okx news list-regions

List all valid --region values for economic-calendar. Use when a region query returns empty to verify the value.

okx news list-regions [--json]

MCP Tool Reference

Coin Symbol Normalization

The API only accepts standard uppercase ticker symbols (e.g. BTC, ETH, SOL). Users may refer to coins by full names, abbreviations, slang, or local-language nicknames. Always resolve these to the correct ticker before passing to any command. If the intended coin is ambiguous, ask the user to confirm before querying.

Empty Results & Web Search Fallback

OKX news data may be sparse for niche coins or highly specific keyword searches. The API default --begin window is only 72 hours, which alone accounts for many empty results. When a command returns empty or insufficient results, apply these steps in order — do not skip to web search:

1. If --platform was used — broaden --begin to 7 days back, then 30 days back, before changing anything else. Bursty sources routinely return 0 items in the default window but dozens over a wider range.
2. If --importance high was passed — drop it (default is already low = all news).
3. Broaden --begin / --end for any query (not just --platform) when a narrow time window is suspected.
4. Drop --coins to get general news if the coin-specific query yielded nothing.
5. Use web search as a supplement — search the web for "<topic> news site:coindesk.com OR site:cointelegraph.com OR site:theblock.co" to gather additional context, then combine with any OKX results into a unified briefing.
6. Be transparent — tell the user which results came from OKX API vs. web search so they can judge source credibility.

This fallback is especially valuable for:

• Coins with low coverage (e.g. newly listed tokens)
• Highly specific keyword searches with no matches
• --platform queries where the chosen source has uneven posting cadence

Known Limitations

Source Coverage

Platform posting cadence varies and changes over time. Some sources publish many articles per day; others post in bursts with quiet stretches in between. A source returning few or zero articles in the default 72-hour window is not evidence that it is inactive — it may simply not have posted recently, or its recent posts may have been deduplicated out.

Before concluding a --platform-filtered query has no data:

1. Broaden --begin to 7 days back, then 30 days back, and retry.
2. If still empty after a 30-day window, report to the user that no recent articles were found for that source and suggest either removing --platform (to fall back to the aggregated feed) or web search.

Do not hardcode assumptions about which platforms are active — resolve candidates from okx news platforms and let the data speak.

Historical Search Limitations

okx news search and okx news by-coin primarily index recent articles (typically today and recent days). Searching with --begin/--end for dates more than ~7 days ago may return empty results even if articles existed at that time. This is an API indexing limitation, not a data absence.

For historical analysis, okx news coin-trend (sentiment trend data) is more reliable than article search — it retains time-series data for longer periods.

Edge Cases

• Pagination: use --after <cursor> to get next page; cursor comes from nextCursor in response
• Time parameters: --begin / --end are Unix epoch milliseconds
• Coins format: comma-separated uppercase symbols, e.g. BTC,ETH,SOL — never pass full names or aliases
• coin-trend --points: always pass explicitly; 1h→24, 4h→6, 24h→7
• Language: inferred from user's message — --lang zh-CN for Chinese, --lang en-US for English (default)
• sentiment-rank --sort-by: hot=by mention count (default), bullish=most bullish, bearish=most bearish