OKX News & Sentiment
Crypto news aggregation and coin sentiment analysis for OKX. All commands are
read-only
and require
API credentials
(OAuth2.1).
Capabilities
User Intent
Command
Latest/important news
okx news latest
Coin-specific news
okx news by-coin
Keyword news search
okx news search
Sentiment-filtered news
okx news by-sentiment
Full article content
okx news detail
Coin sentiment snapshot
okx news coin-sentiment
Sentiment trend
okx news coin-trend
Sentiment ranking
okx news sentiment-rank
News source list
okx news platforms
Prerequisites
Install
okx
CLI:
npm
install
-g
@okx_ai/okx-trade-cli
Configure credentials in
~/.okx/config.toml
Verify setup:
okx news latest
--limit
3
OKX News does not support demo mode. Always use
--profile live
silently — don't mention it unless there's an error.
On "not available in demo" errors:
the user's current profile is configured with demo/simulated credentials. Tell the user: "News module does not support demo mode. Please switch to a live profile." Guide them to either:
Use
--profile live
if a live profile exists:
okx --profile live news latest
Or create one:
okx config add-profile AK=
Latest news
okx news latest --limit 5
Today's important news
okx news important --begin $( date -d 'today 00:00:00' +%s000 2
/dev/null || date -v0H -v0M -v0S +%s000 )
BTC news
okx news by-coin --coins BTC
Search for SEC ETF news
okx news search --keyword "SEC ETF"
BTC sentiment overview
okx news coin-sentiment --coins BTC
Trending coins (hottest right now)
- okx news sentiment-rank
- Intent → Command Mapping
- Browse News
- User says
- Command
- "what's been happening in crypto lately" / "catch me up on recent news"
- okx news latest
- "any big news today" / "what are the major stories right now"
- okx news important
- "what happened in crypto yesterday"
- okx news latest --begin
--end - "any news on BTC recently" / "what's going on with BTC"
- okx news by-coin --coins BTC
- "any major updates on ETH or SOL"
- okx news by-coin --coins ETH,SOL --importance high
- Search News
- User says
- Command
- "any updates on the SEC ETF decision"
- okx news search --keyword "SEC ETF"
- "what's the latest on stablecoin regulation"
- okx news search --keyword "stablecoin regulation"
- "any news about the Bitcoin halving"
- okx news search --keyword "Bitcoin halving"
- Coin Sentiment Analysis
- User says
- Command
- "is the market bullish or bearish on BTC right now" / "how do people feel about BTC"
- okx news coin-sentiment --coins BTC
- "compare how people feel about ETH vs SOL"
- okx news coin-sentiment --coins ETH,SOL
- "how has BTC sentiment changed over the past 24 hours"
- okx news coin-trend BTC --period 1h --points 24
- "show me BTC sentiment over the past week"
- okx news coin-trend BTC --period 24h --points 7
- "what's hot in crypto right now" / "which coins are getting the most attention"
- okx news sentiment-rank
- "which coins are people most excited about" / "top bullish coins"
- okx news sentiment-rank --sort-by bullish
- "which coins have the most negative sentiment"
- okx news sentiment-rank --sort-by bearish
- Sentiment Anomaly Detection (multi-coin)
- User says
- Workflow
- "哪些币种情绪变化最大" / "any sentiment anomalies" / "which coins flipped sentiment"
- →
- Anomaly Detection workflow
- "过去一周有什么异动" / "sudden sentiment shifts" / "sentiment reversal"
- →
- Anomaly Detection workflow
- "有没有突然转看涨/看跌的" / "any coins turning bullish/bearish"
- →
- Anomaly Detection workflow
- These queries require a
- broad-then-deep
- approach: first scan all coins for anomalies, then deep-dive with news correlation. Follow the multi-phase workflow in
- references/workflows.md
- — do NOT just pick a few coins to analyze.
- Source-Filtered News
- Use
- --platform
- to filter by news source directly. Get available source names from
- okx news platforms
- first.
- User says
- Command
- "ChainCatcher 最近报道了什么" / "show me news from ChainCatcher"
- okx news latest --platform chaincatcher --importance low --limit 10
- "Odaily 有什么新闻" / "news from techflowpost"
- okx news latest --platform odaily_flash --limit 10
- "吴说区块链最近有什么" / "BWE news"
- okx news latest --platform wushou --importance low --limit 20
- Important
- When filtering by source, always use
--importance low
and a larger
--limit
(10-20) to maximize results, since individual sources typically have fewer articles than the aggregated feed. The
--platform
parameter accepts values from
okx news platforms
(e.g.
blockbeats
,
odaily_flash
,
chaincatcher
,
techflowpost
,
bwe
,
528btc
,
panews
,
wushou
).
Cross-Skill Workflows
See
references/workflows.md
for multi-step scenarios (market overview, daily briefing, etc.) and full MCP tool → CLI mapping.
Command Reference
okx news latest
Get the latest crypto news sorted by time.
okx news latest
[
--coins BTC,ETH
]
[
--begin
<
ms
] [ --end < ms
] [ --importance high | low ] [ --platform < source
] [ --detail-lvl brief | summary | full ] [ --lang zh-CN | en-US ] [ --limit 10 ] [ --after < cursor
] [ --json ] okx news important Get high-impact breaking news (reported by multiple sources). okx news important [ --coins BTC,ETH ] [ --begin < ms
] [ --end < ms
] [ --detail-lvl brief | summary | full ] [ --lang zh-CN | en-US ] [ --limit 10 ] [ --json ] okx news by-coin Get news for specific coins. okx news by-coin --coins < BTC,ETH, .. .
[ --importance high | low ] [ --platform < source
] [ --begin < ms
] [ --end < ms
] [ --lang zh-CN | en-US ] [ --limit 10 ] [ --json ] 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 ] 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 ] 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
- ]
- MCP Tool Reference
- Tool
- Description
- news_get_latest
- Latest news sorted by time; pass
- importance=high
- for breaking news only
- news_get_by_coin
- News for specific coins (
- coins
- is comma-separated string)
- news_search
- Full-text keyword search with filters (optional
- sentiment
- filter)
- news_get_detail
- Full article content by ID
- news_get_domains
- List available news source domains
- news_get_coin_sentiment
- Sentiment snapshot (no
- trendPoints
- ) or time-series trend (pass
- trendPoints
- )
- news_get_sentiment_ranking
- Coin ranking by hotness or sentiment direction
- 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. When a command returns empty or insufficient results:
- Retry with relaxed filters
- — remove
- --importance
- , broaden
- --begin
- /
- --end
- , or drop
- --coins
- to get general news
- Use web search as a supplement
- — search the web for
- "
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
- 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
- Known Limitations
- Source Coverage
- Not all registered platforms in
- okx news platforms
- are actively producing articles. Based on recent evaluation, the consistently active sources are:
- Source
- Status
- Notes
- blockbeats
- Active
- High volume
- odaily_flash
- Active
- High volume
- chaincatcher
- Active
- Medium volume
- techflowpost
- Active
- Medium volume
- bwe
- Low activity
- Few articles per week
- panews
- Inconsistent
- Registered but rarely appears in aggregated results; dedup issues
- 528btc
- Inactive
- Registered but no articles found in 90+ days
- wushou
- Inactive
- Registered but no articles found in 90+ days
- When a user asks for news from an inactive source, do NOT retry repeatedly or page through hundreds of articles looking for it. Instead, report that the source currently has no data and suggest alternatives (other active sources or web search).
- 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
- 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