Okx Sentiment Tracker

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

Prerequisites

1. Install okx CLI: ``bash npm install -g @okx_ai/okx-trade-cli ``
2. Configure credentials in ~/.okx/config.toml
3. 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.

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.

Search News

Coin Sentiment Analysis

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

How to choose before / after:

Notes:

• ⚠️ ALWAYS use both `--before` AND `--after` for future-event queries. --before alone returns to 2028 and limit clips the wrong end. The only exception is past-event queries where default after=now is correct.
• Rate limit: 1 request per 5 seconds (IP-based). Do NOT call repeatedly.
• No keyword/event filter — scan response event field client-side. Use a single API call with --limit 100 and broad window, then filter results locally (do NOT loop calls trying different keywords).
• When user asks for a specific importance level (e.g. "重要的", "high importance"), pass --importance 3 AND only include importance=3 events in output. Do NOT pad the response with lower-importance events.
• When searching for a specific event (NFP, CPI, ECB decision), always add --importance 3 to reduce noise — these are all high-importance events. Use --limit 100 and a wide window to ensure the target event is captured.
• actual="" = not yet released; non-empty = released.
• Historical data >3 months requires VIP1+.
• Demo mode not supported — use --profile live silently.
• --region values are snake_case (e.g. united_states, euro_area). Invalid values silently return empty results (no error). If you get empty results and suspect a region typo, run okx news list-regions to get the full list of 210 valid values, then fuzzy-match the user's input and retry. If unsure of the exact value, omit `--region` and filter results client-side by the region field in the response.

BTC Macro Impact (cross-skill)