/okx-sentiment-tracker

name: okx-sentiment-tracker
description: "Use this skill when the user asks about: 'any crypto news', 'latest news', 'market update', 'daily briefing', 'BTC news', 'ETH news', 'news on SOL', 'search SEC ETF', 'regulation news', 'Bitcoin halving', 'is BTC bullish or bearish', 'coin sentiment', 'sentiment trend', 'trending coins', 'top bullish coins', 'bearish sentiment', 'social buzz', 'market mood', 'fear and greed', 'full article', 'read more', 'economic calendar', '经济日历', 'macro data', '宏观数据', 'NFP', 'nonfarm', '非农', 'CPI', 'GDP', 'FOMC', '利率决议', 'interest rate decision', 'PMI', 'unemployment rate', '失业率', 'economic events', '经济事件', or any request for crypto news, market intelligence, sentiment analysis, social trend data, or macro-economic calendar. Requires API credentials. Do NOT use for market prices/candles (okx-cex-market), placing orders (okx-cex-trade), or account info (okx-cex-portfolio)."
license: MIT
metadata:
  author: okx
  version: "1.4.1"
  homepage: "https://www.okx.com"
  agent:
    requires:
      bins: ["okx"]
    install:
      - id: npm
        kind: node
        package: "@okx_ai/okx-trade-cli@1.4.1"
        bins: ["okx"]
        label: "Install okx CLI (npm)"

OKX News & Sentiment

Crypto news aggregation, coin sentiment analysis, and macro-economic calendar 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` | | Economic calendar query | `okx news economic-calendar` | | Valid calendar regions | `okx news list-regions` |

Prerequisites

1. Install `okx` CLI:

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

2. Configure credentials in `~/.okx/config.toml` 3. 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=<key> SK=<secret> PP=<passphrase> name=live`

All commands support `--json` for raw JSON output.

Quickstart

# 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

Intent → Command Mapping

Browse News

`latest`, `by-coin`, and `search` default `--importance low`, which returns **all** news (both high and low importance). Pass `--importance high` only when the user explicitly asks for major / breaking / important news. The dedicated `okx news important` command is a shortcut for that case.

| 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` |

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` |

Economic Calendar

> **CRITICAL — always use BOTH `--before` AND `--after` to form a time window.** Using `--before` alone returns events all the way to 2028 in reverse order — `--limit` then clips the FARTHEST events, not the nearest. Always pair them. > > Semantics (counterintuitive): `--before <ts>` = events NEWER than ts (lower bound), `--after <ts>` = events OLDER than ts (upper bound, default=now).

| User says | Command | |-----------|---------| | "今天有什么经济数据" / "economic events today" | `okx news economic-calendar --before <today_0am_ms> --after <tomorrow_0am_ms> --limit