okx-sentiment-tracker
热门当用户询问以下内容时使用此技能：'任何加密货币新闻'、'最新新闻'、'市场更新'、'每日简报'、'BTC新闻'、'ETH新闻'、'SOL新闻'、'搜索SEC ETF'、'监管新闻'、'比特币减半'、'BTC是看涨还是看跌'、'币种情绪'、'情绪趋势'、'热门币种'、'看涨币种排名'、'看跌情绪'、'社交热度'、'市场情绪'、'恐惧与贪婪'、'全文'、'阅读更多'、'经济日历'、'经济日历'、'宏观数据'、'宏观数据'、'非农'、'非农'、'非农'、'CPI'、'GDP'、'FOMC'、'利率决议'、'利率决议'、'PMI'、'失业率'、'失业率'、'经济事件'、'经济事件'，或任何关于加密货币新闻、市场情报、情绪分析、社交趋势数据或宏观经济日历的请求。需要API凭证。请勿用于市场价格/蜡烛图（okx-cex-market）、下单（okx-cex-trade）或账户信息（okx-cex-portfolio）。
当用户询问以下内容时使用此技能：'任何加密货币新闻'、'最新新闻'、'市场更新'、'每日简报'、'BTC新闻'、'ETH新闻'、'SOL新闻'、'搜索SEC ETF'、'监管新闻'、'比特币减半'、'BTC是看涨还是看跌'、'币种情绪'、'情绪趋势'、'热门币种'、'看涨币种排名'、'看跌情绪'、'社交热度'、'市场情绪'、'恐惧与贪婪'、'全文'、'阅读更多'、'经济日历'、'经济日历'、'宏观数据'、'宏观数据'、'非农'、'非农'、'非农'、'CPI'、'GDP'、'FOMC'、'利率决议'、'利率决议'、'PMI'、'失业率'、'失业率'、'经济事件'、'经济事件'，或任何关于加密货币新闻、市场情报、情绪分析、社交趋势数据或宏观经济日历的请求。需要API凭证。请勿用于市场价格/蜡烛图（okx-cex-market）、下单（okx-cex-trade）或账户信息（okx-cex-portfolio）。
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 |
前提条件
- 安装
okxCLI：npm install -g @okx_ai/okx-trade-cli - 在
~/.okx/config.toml中配置凭证 - 验证设置：
okx news latest --limit 3
OKX 新闻不支持演示模式。始终静默使用 --profile live —— 除非出现错误，否则不要提及。
关于“演示模式不可用”错误： 用户当前配置文件配置了演示/模拟凭证。告知用户：“新闻模块不支持演示模式。请切换到真实配置文件。”指导他们：
- 如果存在真实配置文件，使用
--profile live：okx --profile live news latest - 或者创建一个：
okx config add-profile AK=<key> SK=<secret> PP=<passphrase> name=live
所有命令支持 --json 以输出原始 JSON。
快速开始
# 最新新闻
okx news latest --limit 5
# 今日重要新闻
okx news important --begin $(date -d 'today 00:00:00' +%s000 2>/dev/null || date -v0H -v0M -v0S +%s000)
# BTC 新闻
okx news by-coin --coins BTC
# 搜索 SEC ETF 新闻
okx news search --keyword "SEC ETF"
# BTC 情绪概览
okx news coin-sentiment --coins BTC
# 热门币种（当前最热）
okx news sentiment-rank
# 即将到来的经济事件（仅今日）
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 旧的事件（上限，默认=现在）。
| 用户说 | 命令 |
|---|---|
| “今天有什么经济数据” / “economic events today” | 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 |
| “非农什么时候出” / “when is NFP” | okx news economic-calendar --region united_states --importance 3 --before <now_ms> --after <now_plus_60d_ms> --limit 100 然后在客户端过滤 event 字段中的“Non Farm” |
| “CPI出来了吗” / “latest CPI data” | okx news economic-calendar --region united_states --importance 3 --limit 20（默认 after=now 获取过去的高重要性事件；检查 actual 字段） |
| “欧洲央行利率决议” / “ECB rate decision” | 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字段。使用单个 API 调用，设置--limit 100和宽窗口，然后在本地过滤结果（不要循环调用尝试不同关键词）。 - 当用户要求特定重要性级别（例如“重要的”、“high importance”）时，传递
--importance 3并且只输出重要性为3的事件。不要用低重要性事件填充响应。 - 搜索特定事件（NFP、CPI、ECB决策）时，始终添加
--importance 3以减少噪音——这些都是高重要性事件。使用--limit 100和宽窗口以确保目标事件被捕获。 actual=""= 尚未发布；非空 = 已发布。- 超过3个月的历史数据需要VIP1+。
- 不支持演示模式——静默使用
--profile live。 --region值为蛇形命名（例如united_states、euro_area）。无效值静默返回空结果（无错误）。如果得到空结果并怀疑区域拼写错误，运行okx news list-regions获取210个有效值的完整列表，然后模糊匹配用户输入并重试。如果不确定确切值，省略--region并在客户端根据响应中的region字段过滤结果。
BTC 宏观影响（跨技能）
| 用户说 | 工作流 |
|---|---|
| “BTC受哪些宏观数据冲击” / “macro impact on BTC this week” | → BTC宏观影响工作流 |
| “这周宏观对加密有什么影响” / “how will macro data affect crypto” | → 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；不要硬编码假设哪些平台活跃。
跨技能工作流
参见 references/workflows.md 了解多步骤场景（市场概览、每日简报等）和完整的 MCP 工具到 CLI 映射。
命令参考
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> # 来自之前结果的新闻ID
[--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] # 聚合粒度，默认24h
[--json]
返回：symbol、label（看涨/看跌/中性/混合）、bullishRatio、bearishRatio、mentionCount。
okx news coin-trend
获取币种的时间序列情绪趋势。注意：使用位置参数（不是 --coins）。
okx news coin-trend <coin> # 位置参数，例如 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 [--period 1h|4h|24h]
[--sort-by hot|bullish|bearish] # hot=按提及数（默认），bullish，bearish
[--limit 10] # 最多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/5s |
news_list_calendar_regions |
列出经济日历的所有210个有效区域值 |
币种符号标准化
API 只接受标准大写交易代码（例如 BTC、ETH、SOL）。用户可能通过全名、缩写、俚语或本地语言昵称提及币种。在传递给任何命令之前，始终将这些解析为正确的交易代码。如果目标币种不明确，在查询前请用户确认。
空结果与网络搜索回退
OKX 新闻数据对于小众币种或高度特定的关键词搜索可能稀疏。API 默认 --begin 窗口仅为72小时，这本身就导致许多空结果。当命令返回空或不足的结果时，按顺序应用以下步骤——不要跳过到网络搜索：
- 如果使用了
--platform——先将--begin扩展到7天前，然后30天前，再更改其他内容。爆发式来源通常在默认窗口中返回0条，但在更宽范围内返回数十条。 - 如果传递了
--importance high——去掉它（默认已经是low= 所有新闻）。 - 对于任何查询（不仅仅是
--platform），当怀疑时间窗口过窄时，放宽--begin/--end。 - 如果币种特定查询没有结果，去掉
--coins以获取一般新闻。 - 使用网络搜索作为补充——搜索网络
"<topic> news site:coindesk.com OR site:cointelegraph.com OR site:theblock.co"以收集更多上下文，然后与任何 OKX 结果合并成统一简报。 - 保持透明——告知用户哪些结果来自 OKX API，哪些来自网络搜索，以便他们判断来源可信度。
此回退特别适用于：
- 覆盖范围低的币种（例如新上市代币）
- 高度特定的关键词搜索无匹配
--platform查询中选定来源发布节奏不均匀
已知限制
来源覆盖
平台发布节奏各不相同且随时间变化。有些来源每天发布多篇文章；其他则间歇性发布，中间有安静期。一个来源在默认72小时窗口内返回少量或零篇文章并不证明它不活跃——它可能只是最近没有发布，或者最近的文章已被去重移除。
在断定 --platform 过滤的查询没有数据之前：
- 将
--begin扩展到7天前，然后30天前，并重试。 - 如果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=最看跌
