okx-sentiment-tracker

OKX 新闻与情绪

为 OKX 汇总加密货币新闻、分析币种情绪并提供宏观经济日历。所有命令均为只读，且需要API 凭据（OAuth2.1）。

功能

用户意图	命令
最新／重要新闻	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
查询经济日历	okx news economic-calendar
有效的日历地区	okx news list-regions

前提条件

1. 安装 okx CLI：

   npm install -g @okx_ai/okx-trade-cli
   

2. 在 ~/.okx/config.toml 中配置凭据
3. 验证设置：

   okx news latest --limit 3
   

OKX News 不支持演示模式。请始终静默使用 --profile live；除非出现错误，否则不要提及它。

**遇到“not available in demo”错误时：**用户当前配置的是演示／模拟凭据。请告知用户：“新闻模块不支持演示模式。请切换到实时配置。”引导用户选择以下任一方式：

• 如果已有实时配置，使用 --profile live：okx --profile live news latest
• 或创建一个：okx config add-profile AK=<key> SK=<secret> PP=<passphrase> name=live

所有命令均支持使用 --json 输出原始 JSON。

快速开始

# 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

# Upcoming economic events (today only)
okx news economic-calendar --before $(date -v0H -v0M -v0S +%s000) --after $(date -v+1d -v0H -v0M -v0S +%s000) --limit 100

意图 → 命令映射

浏览新闻

latest、by-coin 和 search 默认使用 --importance low，会返回所有新闻（包括高重要性和低重要性新闻）。仅当用户明确要求重大／突发／重要新闻时，才传入 --importance high。专用命令 okx news important 是此类情况的快捷方式。

用户说	命令
“最近加密货币领域有什么新动态”／“给我介绍一下近期新闻”	okx news latest
“今天有什么大新闻吗”／“现在有哪些重大新闻”	okx news important
“昨天加密货币领域发生了什么”	okx news latest --begin <yesterday_0am> --end <today_0am>
“最近有 BTC 的新闻吗”／“BTC 最近有什么动向”	okx news by-coin --coins BTC
“ETH 或 SOL 有什么重大进展吗”	okx news by-coin --coins ETH,SOL --importance high

搜索新闻

用户说	命令
“SEC ETF 决策有什么新进展吗”	okx news search --keyword "SEC ETF"
“稳定币监管方面有什么最新消息”	okx news search --keyword "stablecoin regulation"
“比特币减半有什么新闻吗”	okx news search --keyword "Bitcoin halving"

币种情绪分析

用户说	命令
“现在市场看好还是看空 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

经济日历

重要 — 始终同时使用 --before 和 --after 来构造时间窗口。 仅使用 --before 会按倒序返回一直到 2028 年的事件，随后 --limit 截取的是最远的事件，而不是最近的事件。务必同时使用这两个参数。

参数含义（有悖直觉）：--before <ts> = 晚于 ts 的事件（下界），--after <ts> = 早于 ts 的事件（上界，默认为 now）。

用户说	命令
"今天有什么经济数据" / "今天有哪些经济事件"	okx news economic-calendar --before <today_0am_ms> --after <tomorrow_0am_ms> --limit 100
"这周美国有什么重要经济事件"	okx news economic-calendar --region united_states --importance 3 --before <week_start_ms> --after <week_end_ms> --limit 100
"非农什么时候出" / "NFP 什么时候公布"	okx news economic-calendar --region united_states --importance 3 --before <now_ms> --after <now_plus_60d_ms> --limit 100 然后在客户端筛选 event 字段中的 "Non Farm"
"CPI 出来了吗" / "最新 CPI 数据"	okx news economic-calendar --region united_states --importance 3 --limit 20（默认 after=now 会获取过去的重要事件；检查 actual 字段）
"欧洲央行利率决议" / "ECB 利率决议"	okx news economic-calendar --region euro_area --importance 3 --before <now_ms> --after <now_plus_90d_ms> --limit 100 然后筛选 "Interest Rate Decision"

如何选择 before / after：

意图	参数	说明
今天的事件	--before <today_0am> --after <tomorrow_0am>	窗口 = 今天 0:00 → 明天 0:00
本周的事件	--before <week_start> --after <week_end>	窗口 = 周一 0:00 → 周日 24:00
接下来 N 天	--before <now> --after <now_plus_Nd>	窗口 = 现在 → N 天后
过去的事件（默认）	省略两个参数，或使用 --after <upper_bound>	默认 after=now，返回近期过去的事件
历史时间窗口	--before <window_start> --after <window_end>	显式指定上下界

注意：

• ⚠️ 查询未来事件时，始终同时使用 --before 和 --after。仅使用 --before 会返回一直到 2028 年的事件，而且 limit 会截取错误的一端。唯一例外是查询过去的事件，此时默认 after=now 是正确的。
• 速率限制：每 5 秒 1 次请求（基于 IP）。不要重复调用。
• 不支持关键词／事件筛选 — 在客户端扫描响应中的 event 字段。使用一次 --limit 100 API 调用并设置较宽的时间窗口，然后在本地筛选结果（不要尝试不同关键词并循环调用）。
• 用户指定重要性级别（例如“重要的”“高重要性”）时，传入 --importance 3，并且输出中仅包含 importance=3 的事件。不要用较低重要性的事件凑数。
• 搜索特定事件（NFP、CPI、ECB 决议）时，始终添加 --importance 3 以减少无关结果 — 这些都是高重要性事件。使用 --limit 100 和较宽的时间窗口，确保能找到目标事件。
• actual="" = 尚未公布；非空 = 已公布。
• 超过 3 个月的历史数据需要 VIP1+。
• 不支持演示模式 — 静默使用 --profile live。
• --region 的值使用 snake_case（例如 united_states、euro_area）。无效值会静默返回空结果（不会报错）。如果结果为空且怀疑区域名称拼写错误，请运行 okx news list-regions 获取 210 个有效值的完整列表，然后模糊匹配用户输入并重试。如果不确定确切值，省略 --region，并在客户端根据响应中的 region 字段筛选结果。

BTC 宏观影响（跨技能）

用户说	工作流
"BTC 受哪些宏观数据冲击" / "本周宏观因素对 BTC 的影响"	→ BTC 宏观影响工作流
"这周宏观对加密有什么影响" / "宏观数据会如何影响加密货币"	→ BTC 宏观影响工作流

这些查询需要并行执行经济日历、BTC 情绪／新闻和市场数据。不要按顺序运行。

情绪异常检测（多币种）

用户说	工作流
“哪些币种情绪变化最大” / “any sentiment anomalies” / “which coins flipped sentiment”	→ 异常检测工作流
“过去一周有什么异动” / “sudden sentiment shifts” / “sentiment reversal”	→ 异常检测工作流
“有没有突然转看涨/看跌的” / “any coins turning bullish/bearish”	→ 异常检测工作流

这些查询需要采用先广后深的方法：先扫描所有币种以发现异常，再深入分析并关联新闻。请遵循 references/workflows.md 中的多阶段工作流，不要只挑选几个币种进行分析。

按来源筛选新闻

使用 --platform 直接按新闻来源筛选。务必从 okx news platforms 获取准确值，不要根据用户的措辞猜测平台标识符。

用户说	命令
“ChainCatcher 最近报道了什么” / “show me news from ChainCatcher”	okx news latest --platform <platform_id> --limit 10
“Odaily 有什么新闻” / “news from TechFlowPost”	okx news latest --platform <platform_id> --limit 10
“吴说区块链最近有什么” / “news from a specific outlet”	okx news latest --platform <platform_id> --limit 20

重要：按来源筛选时，请使用较大的 --limit（10–20）以尽可能多地获取结果，因为单个来源的文章通常少于聚合信息流。此处应使用 --importance low（默认值），不要缩小范围至 --importance high。

各平台的发文频率并不均匀。 API 默认将 --begin 设为 72 小时前，这个时间范围对于发文量突增的来源来说过窄，通常会返回 0 条结果。如果按 --platform 筛选的查询返回少于约 5 条（或 0 条），在得出该来源没有数据的结论前，请将 --begin 依次改为 7 天前和 30 天前重试。请从 okx news platforms 获取候选平台 ID；不要硬编码关于哪些平台处于活跃状态的假设。

跨技能工作流

多步骤场景（市场概览、每日简报等）以及完整的 MCP 工具 → CLI 映射，请参阅 references/workflows.md。

命令参考

okx news latest

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

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]

--importance 默认值为 low（返回所有新闻，包括高重要性和低重要性）。传入 --importance high 可仅获取突发／重大新闻，也可使用 okx news important。

---

okx news important

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

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

获取特定币种的新闻。

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

--importance 默认值为 low（返回所有新闻）。只有在获取突发／重大新闻时才传入 --importance high。

---

okx news search

全文关键词搜索，可选择添加筛选条件。

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 默认值为 low（返回所有新闻）。只有在获取突发／重大新闻时才传入 --importance high。

---

okx news detail

按 ID 获取文章全文。

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

---

okx news by-sentiment

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

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 默认值为 low（返回所有新闻）。只有在获取突发／重大新闻时才传入 --importance high。

---

okx news platforms

列出可用的新闻平台。使用返回的值，在 latest、by-coin 或 search 命令中通过 --platform 按来源筛选。

okx news platforms [--json]

---

okx news coin-sentiment

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

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

返回：symbol、label（看涨／看跌／中性／混合）、bullishRatio、bearishRatio、mentionCount。

---

okx news coin-trend

获取某个币种的情绪时间序列趋势。注意：使用位置参数（而非 --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 参考：1h 周期 → 使用 24（过去 24h），4h → 使用 6，24h → 使用 7。

---

okx news sentiment-rank

按社交热度或情绪方向获取币种排名。

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

获取宏观经济日历数据。超过 3 个月的历史数据需要 VIP1+。

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

速率限制：每 5 秒 1 个请求（按 IP 计算）。限制比其他新闻命令严格得多。

before/after 的含义相反：--before <ts> = 晚于 ts（未来），--after <ts> = 早于 ts（过去）。示例请参阅经济日历意图映射。

常见地区：united_states、china、euro_area、united_kingdom、japan、germany、canada、australia

重要性：1=低，2=中，3=高

---

okx news list-regions

列出 economic-calendar 的所有有效 --region 值。如果地区查询返回空结果，可用此命令验证取值。

okx news list-regions [--json]

---

MCP 工具参考

工具	说明
news_get_latest	按时间排序的最新新闻。服务端默认 importance=high（范围较窄）；传入 importance=low 可扩大范围，获取所有新闻。
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	按热度或情绪方向获取币种排名
news_get_economic_calendar	宏观经济日历数据；速率限制为 1/5 秒
news_list_calendar_regions	列出 economic-calendar 的全部 210 个有效地区值

币种代码规范化

API 仅接受标准大写代码（例如 BTC、ETH、SOL）。用户可能会使用全名、缩写、俚语或本地语言昵称来称呼币种。传递给任何命令前，务必将其解析为正确的代码。如果目标币种存在歧义，请先让用户确认，再进行查询。

空结果与网页搜索回退

对于小众币种或高度具体的关键词搜索，OKX 新闻数据可能较少。API 默认的 --begin 时间范围仅为 72 小时，这本身就会导致许多空结果。命令返回空结果或结果不足时，请按以下步骤依次处理，不要跳过直接进行网页搜索：

1. 如果使用了 --platform——先将 --begin 扩大到 7 天前，再扩大到 30 天前，然后再更改其他内容。来源发布节奏不均，默认时间范围内经常返回 0 条，但扩大范围后可能有数十条。
2. 如果传入了 --importance high——移除该参数（默认值已是 low = 所有新闻）。
3. 对任何查询（不限于 --platform），如果怀疑时间范围过窄，请扩大 --begin / --end。
4. 如果按币种查询没有结果，请移除 --coins，以获取一般新闻。
5. 将网页搜索作为补充——搜索 "<topic> news site:coindesk.com OR site:cointelegraph.com OR site:theblock.co"，收集更多背景信息，然后将其与任何 OKX 结果整合为统一简报。
6. 如实说明——告知用户哪些结果来自 OKX API，哪些来自网页搜索，以便用户判断来源的可信度。

以下情况尤其适合使用此回退方式：

• 覆盖度较低的币种（例如新上市的代币）
• 没有匹配结果的高度具体关键词搜索
• --platform 查询中所选来源发布节奏不均的情况

已知限制

来源覆盖情况

各平台的发帖频率会有所不同，也会随时间变化。有些来源每天发布许多文章；有些则会集中发布，中间间隔一段时间。某个来源在默认的 72 小时窗口内返回的文章很少或为零，并不代表它已不活跃——它可能只是最近没有发帖，或者最近的帖子在去重时被过滤掉了。

在断定经过 --platform 筛选的查询没有数据之前：

1. 将 --begin 的范围扩大到 7 天前，然后扩大到 30 天前，并重试。
2. 如果 30 天窗口内仍无结果，请告知用户该来源近期没有文章，并建议移除 --platform（以回退到聚合信息流），或使用网页搜索。

不要对哪些平台处于活跃状态作出硬编码假设——通过 okx news platforms 获取候选平台，并以数据为准。

历史搜索限制

okx news search 和 okx news by-coin 主要索引近期文章（通常是当天及最近几天的文章）。使用 --begin/--end 搜索约 7 天以前的日期时，即使当时有文章，也可能返回空结果。这是 API 索引限制，并不表示数据不存在。

进行历史分析时，okx news coin-trend（情绪趋势数据）比文章搜索更可靠——它会保留更长时间的时间序列数据。

边缘情况

• 分页：使用 --after <cursor> 获取下一页；游标来自响应中的 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=看跌程度最高