okx-sentiment-tracker

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OKX News & Sentiment

OKX 新闻与情绪分析

Crypto news aggregation and coin sentiment analysis for OKX. All commands are read-only and require API credentials (OAuth2.1).

针对OKX的加密货币新闻聚合与币种情绪分析工具。所有命令均为只读，且需要API凭证（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`

用户意图	命令
最新/重要新闻	`okx news latest`
指定币种新闻	`okx news by-coin`
关键词新闻搜索	`okx news search`
按情绪筛选新闻	`okx news by-sentiment`
完整文章内容	`okx news detail`
币种情绪快照	`okx news coin-sentiment`
情绪趋势	`okx news coin-trend`
情绪排名	`okx news sentiment-rank`
新闻来源列表	`okx news platforms`

Prerequisites

前置条件

Install
```
okx
```
CLI:
bash
```
npm install -g @okx_ai/okx-trade-cli
```
Configure credentials in
```
~/.okx/config.toml
```
Verify setup:
bash
```
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=<key> SK=<secret> PP=<passphrase> name=live

All commands support

--json

for raw JSON output.

安装
```
okx
```
CLI：
bash
```
npm install -g @okx_ai/okx-trade-cli
```
在
```
~/.okx/config.toml
```
中配置凭证
验证安装：
bash
```
okx news latest --limit 3
```

OKX News不支持演示模式。请默认使用

--profile live

，除非出现错误否则无需提及。

遇到“演示模式不可用”错误时：用户当前配置的是演示/模拟凭证。请告知用户：“新闻模块不支持演示模式，请切换至真实环境配置文件。”并引导用户：

若已有真实环境配置文件，使用
```
--profile live
```
：
```
okx --profile live news latest
```

或创建新配置文件：

okx config add-profile AK=<密钥> SK=<密钥密码> PP=<口令> name=live

所有命令均支持

--json

参数以输出原始JSON格式数据。

Quickstart

快速开始

bash

undefined

bash

undefined

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

获取BTC新闻

okx news by-coin --coins BTC

Search for SEC ETF news

搜索SEC ETF相关新闻

okx news search --keyword "SEC ETF"

BTC sentiment overview

获取BTC情绪概览

okx news coin-sentiment --coins BTC

Trending coins (hottest right now)

获取热门币种（当前最受关注）

okx news sentiment-rank

undefined

okx news sentiment-rank

undefined

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 <yesterday_0am> --end <today_0am>`
"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`

用户提问	命令
“最近加密货币领域有什么动态” / “帮我了解近期新闻”	`okx news latest`
“今日有什么重大新闻” / “当前主要热点是什么”	`okx news important`
“昨天加密货币领域发生了什么”	`okx news latest --begin <昨日0点时间戳> --end <今日0点时间戳>`
“最近BTC有什么新闻” / “BTC近况如何”	`okx news by-coin --coins BTC`
“ETH或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"`

用户提问	命令
“SEC ETF决策有什么最新进展”	`okx news search --keyword "SEC ETF"`
“稳定币监管最新消息是什么”	`okx news search --keyword "stablecoin regulation"`
“比特币减半相关新闻有哪些”	`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`

用户提问	命令
“当前市场对BTC是看涨还是看跌” / “人们对BTC的看法如何”	`okx news coin-sentiment --coins BTC`
“对比人们对ETH和SOL的看法”	`okx news coin-sentiment --coins ETH,SOL`
“过去24小时BTC情绪有什么变化”	`okx news coin-trend BTC --period 1h --points 24`
“展示过去一周BTC的情绪变化”	`okx news coin-trend BTC --period 24h --points 7`
“当前加密货币领域热门币种是什么” / “哪些币种最受关注”	`okx news sentiment-rank`
“人们最看好哪些币种” / “最看涨币种”	`okx news sentiment-rank --sort-by bullish`
“哪些币种情绪最负面”	`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.

用户提问	工作流
“哪些币种情绪变化最大” / “有没有情绪异常币种” / “哪些币种情绪反转”	→ 异常检测工作流
“过去一周有什么异动” / “突发情绪变化” / “情绪反转”	→ 异常检测工作流
“有没有突然转看涨/看跌的币种” / “哪些币种开始看涨/看跌”	→ 异常检测工作流

此类查询需遵循先广度扫描再深度分析的流程：先扫描所有币种寻找异常，再结合新闻进行深度关联分析。请严格遵循

references/workflows.md

中的多阶段工作流，切勿仅挑选少数币种进行分析。

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

使用

--platform

参数直接按新闻来源筛选。需先通过

okx news platforms

获取可用来源名称。

用户提问	命令
“ChainCatcher最近报道了什么” / “展示ChainCatcher的新闻”	`okx news latest --platform chaincatcher --importance low --limit 10`
“Odaily有什么新闻” / “techflowpost的新闻”	`okx news latest --platform odaily_flash --limit 10`
“吴说区块链最近有什么内容” / “BWE新闻”	`okx news latest --platform wushou --importance low --limit 20`

重要提示：按来源筛选时，需始终使用

--importance low

并设置较大的

--limit

值（10-20）以获取更多结果，因为单个来源的文章数量通常少于聚合信息流。

--platform

参数接受

okx news platforms

返回的值（例如

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.

请查看references/workflows.md获取多步骤场景（市场概览、每日简报等）及完整MCP工具→CLI映射关系。

Command Reference

命令参考

okx news latest

okx news latest

Get the latest crypto news sorted by time.

bash

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]

按时间排序获取最新加密货币新闻。

bash

okx news latest [--coins BTC,ETH] [--begin <毫秒时间戳>] [--end <毫秒时间戳>]
               [--importance high|low] [--platform <来源>]
               [--detail-lvl brief|summary|full] [--lang zh-CN|en-US]
               [--limit 10] [--after <游标>] [--json]

okx news important

okx news important

Get high-impact breaking news (reported by multiple sources).

bash

okx news important [--coins BTC,ETH] [--begin <ms>] [--end <ms>]
                  [--detail-lvl brief|summary|full]
                  [--lang zh-CN|en-US] [--limit 10] [--json]

获取高影响力突发新闻（被多个来源报道）。

bash

okx news important [--coins BTC,ETH] [--begin <毫秒时间戳>] [--end <毫秒时间戳>]
                  [--detail-lvl brief|summary|full]
                  [--lang zh-CN|en-US] [--limit 10] [--json]

okx news by-coin

okx news by-coin

Get news for specific coins.

bash

okx news by-coin --coins <BTC,ETH,...>
               [--importance high|low] [--platform <source>]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--json]

获取指定币种的新闻。

bash

okx news by-coin --coins <BTC,ETH,...>
               [--importance high|low] [--platform <来源>]
               [--begin <毫秒时间戳>] [--end <毫秒时间戳>] [--lang zh-CN|en-US]
               [--limit 10] [--json]

okx news search

okx news search

Full-text keyword search with optional filters.

bash

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]

带可选筛选条件的全文关键词搜索。

bash

okx news search --keyword <文本>
               [--coins BTC,ETH] [--importance high|low]
               [--platform <来源>]
               [--sentiment bullish|bearish|neutral]
               [--sort-by latest|relevant]
               [--begin <毫秒时间戳>] [--end <毫秒时间戳>] [--lang zh-CN|en-US]
               [--limit 10] [--after <游标>] [--json]

okx news detail

okx news detail

Get full article content by ID.

bash

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

通过ID获取完整文章内容。

bash

okx news detail <id>                  # 来自之前结果的新闻ID
               [--lang zh-CN|en-US] [--json]

okx news by-sentiment

okx news by-sentiment

Browse news filtered by sentiment (no keyword needed).

bash

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]

按情绪筛选浏览新闻（无需关键词）。

bash

okx news by-sentiment --sentiment <bullish|bearish|neutral>
               [--coins BTC,ETH] [--importance high|low]
               [--sort-by latest|relevant]
               [--begin <毫秒时间戳>] [--end <毫秒时间戳>] [--lang zh-CN|en-US]
               [--limit 10] [--after <游标>] [--json]

okx news platforms

okx news platforms

List available news platforms. Use the returned values with

--platform

latest

by-coin

, or

search

commands to filter by source.

bash

okx news platforms [--json]

列出可用新闻平台。将返回值与

latest

、

by-coin

或

search

命令的

--platform

参数配合使用，可按来源筛选新闻。

bash

okx news platforms [--json]

okx news coin-sentiment

okx news coin-sentiment

Get current sentiment snapshot for specific coins.

bash

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

获取指定币种的当前情绪快照。

bash

okx news coin-sentiment --coins <BTC,ETH,...>
               [--period 1h|4h|24h]  # 聚合粒度，默认24h
               [--json]

返回字段：

symbol

、

label

（bullish/bearish/neutral/mixed）、

bullishRatio

、

bearishRatio

、

mentionCount

。

okx news coin-trend

okx news coin-trend

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

--coins

bash

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.

获取单个币种的时间序列情绪趋势。注意：使用位置参数（而非

--coins

）。

bash

okx news coin-trend <币种>            # 位置参数，例如BTC
               [--period 1h|4h|24h]  # 聚合粒度，默认1h
               [--points 24]          # 趋势数据点数，默认24
               [--json]

trendPoints

参考：1h周期→设为24（过去24小时），4h→设为6，24h→设为7。

okx news sentiment-rank

okx news sentiment-rank

Get coin ranking by social hotness or sentiment direction.

bash

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

按社交热度或情绪方向对币种进行排名。

bash

okx news sentiment-rank [--period 1h|4h|24h]
               [--sort-by hot|bullish|bearish]  # hot=按提及量排序（默认），bullish=最看涨，bearish=最看跌
               [--limit 10]                     # 最大50
               [--json]

MCP Tool Reference

MCP工具参考

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

工具	描述
`news_get_latest`	按时间排序的最新新闻；传入 `importance=high` 可仅获取突发新闻
`news_get_by_coin`	指定币种的新闻（ `coins` 为逗号分隔的字符串）
`news_search`	带筛选条件的全文关键词搜索（可选 `sentiment` 筛选）
`news_get_detail`	通过ID获取完整文章内容
`news_get_domains`	列出可用新闻来源域名
`news_get_coin_sentiment`	情绪快照（无 `trendPoints` ）或时间序列趋势（传入 `trendPoints` ）
`news_get_sentiment_ranking`	按热度或情绪方向对币种进行排名

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.

API仅接受标准大写代码（例如

BTC

、

ETH

、

SOL

）。用户可能会用全称、缩写、俚语或本地语言昵称指代币种。在传入任何命令前，需将其解析为正确的代码。若币种存在歧义，需先请用户确认再进行查询。

Empty Results & Web Search Fallback

无结果时的网页搜索 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
```
"<coin> 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

对于小众币种或高度特定的关键词搜索，OKX新闻数据可能较为匮乏。当命令返回空结果或结果不足时：

放宽筛选条件重试 — 移除
```
--importance
```
、扩大
```
--begin
```
/
```
--end
```
范围，或取消
```
--coins
```
限制以获取通用新闻
补充网页搜索 — 在网页搜索中使用
```
"<币种> news site:coindesk.com OR site:cointelegraph.com OR site:theblock.co"
```
收集更多信息，再与OKX结果整合为统一简报
保持透明 — 告知用户哪些结果来自OKX API，哪些来自网页搜索，以便用户判断来源可信度

此 fallback 尤其适用于：

报道量低的币种（例如新上线代币）
无匹配结果的高度特定关键词搜索

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

okx news platforms

中并非所有已注册平台都在持续产出文章。根据近期评估，持续活跃的来源包括：

来源	状态	说明
`blockbeats`	活跃	高产出
`odaily_flash`	活跃	高产出
`chaincatcher`	活跃	中等产出
`techflowpost`	活跃	中等产出
`bwe`	低活跃度	每周仅少量文章
`panews`	不稳定	已注册但极少出现在聚合结果中；存在去重问题
`528btc`	不活跃	已注册但90+天未发现文章
`wushou`	不活跃	已注册但90+天未发现文章

当用户询问不活跃来源的新闻时，请勿反复重试或翻找数百篇文章。应告知用户该来源当前无数据，并建议替代方案（其他活跃来源或网页搜索）。

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.

okx news search

和

okx news by-coin

主要索引近期文章（通常为今日及最近几天）。若

--begin

--end

设置为约7天前的日期，即使当时存在文章，也可能返回空结果。这是API索引限制，而非数据不存在。

对于历史分析，

okx news coin-trend

（情绪趋势数据）比文章搜索更可靠——它保留了更长时间的时间序列数据。

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

分页：使用
```
--after <游标>
```
获取下一页；游标来自响应中的
```
nextCursor
```
字段
时间参数：
```
--begin
```
/
```
--end
```
为Unix时间戳（毫秒）
币种格式：逗号分隔的大写代码，例如
```
BTC,ETH,SOL
```
——切勿传入全称或别名
coin-trend的
--points
：需显式传入；1h→24，4h→6，24h→7
语言：根据用户消息自动推断——中文用户使用
```
--lang zh-CN
```
，英文用户使用
```
--lang en-US
```
（默认）
sentiment-rank的
--sort-by
：
```
hot
```
=按提及量排序（默认），
```
bullish
```
=最看涨，
```
bearish
```
=最看跌