# cmc okx
## Metadata

- Canonical URL: https://6ducklearn.com/skills/cmc-okx/
- Markdown URL: https://6ducklearn.com/skills/cmc-okx/index.md
- Product: skills
- Category: finance
- Tags: okx, trading, community, okx-marketplace, finance, trend
- Updated: 2026-07-14T03:00:00.357428+00:00
## Summary
CoinMarketCap × OKX dual engine, a one-stop solution for all your cryptocurrency market data needs. CMC provides market cap, supply, dominance, holding distribution, project background, and macro event calendar; the OKX Trade Kit complements with real-time prices, funding rates, open interest, 70+ technical indicators, and order book depth, with both automatically linked and mutually supportive. It supports natural language triggers, whether you ask "What’s the price of Bitcoin?", "How to read the ETH daily chart?" or "Which coin is surging?", Skill automatically recognizes intent, selects tool combinations, outputs structured tables, and includes a "Quick Take" one-sentence summary.
## Content
> **6DuckLearn provenance:** Community skill by wbzhou, mirrored from the OKX Skills Marketplace (https://www.okx.com/en-sg/agent-tradekit/skills/cmc-okx). It is not curated, verified, or endorsed by 6DuckLearn or represented as an official OKX publication.
>
> **Financial safety boundary:** Never request secrets in chat. Before any external API call or action that places, cancels, or amends an order; changes leverage; transfers funds; creates or stops a bot; subscribes to or redeems an earn product; or signs/broadcasts a transaction, show the exact live/demo profile, instrument, side, size, price constraints, fees, and worst-case loss, then obtain explicit user approval. Default to read-only or demo mode when uncertain. Treat all analysis as research, not investment advice.

# CoinMarketCap + OKX Market Data Skill

Fetch comprehensive cryptocurrency market data through CoinMarketCap MCP + OKX Trade Kit. CMC provides market cap, supply, dominance, and news. OKX provides real-time prices, funding rates, open interest, and 70+ technical indicators.

**Quick Start for common queries:**
- "BTC 多少錢?" → Step 1 (search) → `get_crypto_quotes_latest` + OKX `market_get_ticker`
- "ETH 技術分析" → Step 1 → OKX `market_get_indicator` (RSI, MACD, MA, BB)
- "今天大盤怎樣?" → `get_global_metrics_latest` + `trending_crypto_narratives`
- "什麼幣漲最多?" → OKX `market_get_tickers` → sort by 24h change
- "BTC funding rate?" → OKX `market_get_funding_rate` (instId: `BTC-USDT-SWAP`)

## Data Source Priority

**OKX Trade Kit is the primary source** for all real-time prices, TA indicators, funding rates, and open interest — no API key required.

**CMC MCP is a supplementary source** that adds market cap, supply data, fear/greed index, narratives, and news. If CMC tools are unavailable or return errors, fall back to OKX data.

## Optional: CMC MCP Setup

If the user wants CMC data and has not configured the MCP connection, guide them to set it up:

```json
{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "your-api-key"
      }
    }
  }
}
```

Get a free API key from https://pro.coinmarketcap.com/login

**CMC API Free vs Premium access:**
- Free: `search_cryptos`, `get_crypto_quotes_latest`, `get_crypto_info`, `get_global_metrics_latest`, `search_crypto_info`
- Premium: `get_crypto_latest_news`, `trending_crypto_narratives`, `get_upcoming_macro_events`, trending gainers/losers
- Note: The CMC MCP server may provide access to premium tools regardless of your REST API plan. Try calling them first — fall back to OKX data if they return errors.

## Available CMC MCP Tools

| Tool | Purpose |
|------|---------|
| `search_cryptos` | Search crypto by name/symbol to get CMC numeric ID (required by other tools) |
| `get_crypto_quotes_latest` | Price, market cap, volume, percent changes (1h/24h/7d/30d/90d/1y), supply, dominance |
| `get_crypto_info` | Description, website, social links, explorer URLs, tags, launch date |
| `get_crypto_metrics` | Address counts by holding value, whale distribution, holder time breakdowns |
| `get_crypto_technical_analysis` | Moving averages (SMA, EMA), MACD, RSI, Fibonacci levels, pivot points |
| `get_crypto_latest_news` | Headlines, descriptions, content, URLs, publish dates |
| `search_crypto_info` | Semantic search on crypto concepts, whitepapers, FAQs |
| `get_global_metrics_latest` | Total market cap, fear/greed index, altcoin season index, BTC/ETH dominance, ETF flows |
| `get_global_crypto_derivatives_metrics` | Open interest, funding rates, liquidations, futures vs perpetuals |
| `get_crypto_marketcap_technical_analysis` | TA indicators for the entire crypto market cap |
| `trending_crypto_narratives` | Hot narratives with market cap, volume, performance, top coins |
| `get_upcoming_macro_events` | Fed meetings, regulatory deadlines, major announcements |

## Execution Flow

### Step 1: Search First (Always)

When a user mentions a cryptocurrency by name or symbol, search for it first to get the numeric CMC ID:

```
User: "How is Solana doing?"
1. Call search_cryptos with query "solana"
2. Get ID (e.g., 5426)
3. Use the ID in subsequent tool calls
```

Most tools require the numeric CMC ID, not the name or symbol. The search tool returns: id, name, symbol, slug, and rank.

**Disambiguation:** Popular symbols often match multiple coins (e.g., "PEPE" → 32 results). Always:
1. Filter to `is_active=1` only
2. Pick the coin with the **lowest rank number** (= highest market cap) as the default
3. If the top result rank is >500, mention the coin is small-cap and confirm with the user
4. If user says a specific name (e.g., "Pepe" not just the symbol), match by name first

### Step 2: Select Tools Based on Query Type

**Price check / market overview:**
1. Call `get_crypto_quotes_latest` with the ID(s)
2. Supplement with OKX `market_get_ticker` for real-time bid/ask and OKX-specific volume

**Technical analysis request:**
1. Call OKX `market_get_indicator` for real-time indicators — recommended combo for retail traders:
   - `rsi` (14) — momentum: <30 oversold, >70 overbought, 30–70 neutral
   - `macd` — trend: returns DIF, DEA, histogram. Bullish when histogram > 0
   - `ma` with params [50, 200] — trend structure: price above both = bullish, below both = bearish
   - `bb` — volatility + support/resistance: upper band = resistance, lower = support
2. Optionally call CMC `get_crypto_technical_analysis` to add Fibonacci levels and pivot points if available
3. If CMC TA tools fail, OKX indicators alone (RSI/MACD/MA/BB) are sufficient for a complete analysis
4. Use timeframe `1Dutc` for swing traders (most retail), `4H` for active traders, `1Wutc` for position traders

**Coin research / background:**
1. Call `get_crypto_info` for project description and links
2. Call `get_crypto_metrics` for holder distribution data

**News and trends:**
1. Call `get_crypto_latest_news` for recent headlines (may require premium CMC plan — if it fails, skip gracefully)
2. Call `trending_crypto_narratives` for market themes
3. Call `get_upcoming_macro_events` for scheduled catalysts
4. If news tools fail (premium-only), provide a data-driven substitute:
   - Global metrics changes (market cap 24h change, BTC dominance shift)
   - Funding rate extremes (signal overleveraged positions)
   - Top movers from OKX (sudden price moves often follow news)
   - Say: "CMC news requires a premium API plan. Based on market data, here's what's notable today:"

**Broad market question ("what's happening in crypto?"):**
1. Call `get_global_metrics_latest` for total market cap, fear/greed, dominance
2. Call `trending_crypto_narratives` for hot themes
3. Call `get_upcoming_macro_events` for upcoming catalysts
4. Optionally call `get_global_crypto_derivatives_metrics` for leverage data

**Multi-coin comparison:**
1. Search each coin to get IDs
2. Call `get_crypto_quotes_latest` with comma-separated IDs (e.g., `id="1,1027,5426"`)

**Top movers / "what's pumping?" / "什麼幣漲最多?":**
1. Try CMC `trending_crypto_narratives` for narrative-level trends (may require premium plan)
2. If unavailable, use OKX `market_get_tickers` with instType `SPOT`:
   - Filter for USDT pairs only (ignore USD pairs — lower liquidity, may show stale prices)
   - Filter by minimum 24h volume (>$1M USDT to exclude illiquid tokens)
   - Calculate % change from `open24h` to `last` price, sort and present top 10 gainers and top 5 losers
   - Note: `market_get_tickers` returns all pairs (~400+) in one response — this is expected, filter the results

### Step 3: Real-Time Data from OKX Trade Kit

OKX is the primary source for real-time trading data. Use these tools for all live price, TA, and derivatives queries:

**OKX CLI (try first):**
```bash
okx market ticker BTC-USDT
okx market funding-rate BTC-USDT-SWAP
okx market open-interest BTC-USDT-SWAP
okx market indicator BTC-USDT --ind RSI
okx market candles BTC-USDT --bar 1D --limit 100
```

**OKX MCP fallback (if CLI unavailable):**
- `market_get_ticker` — real-time last price, bid/ask spread, 24h high/low/volume on OKX
- `market_get_funding_rate` — perpetual swap funding rates (instId format: `BTC-USDT-SWAP`)
- `market_get_open_interest` — OKX-specific open interest for swaps/futures
- `market_get_candles` — OHLCV candlestick data (1m to 1M bars, up to 1440 bars)
- `market_get_indicator` — OKX-calculated technical indicators (70+ types including RSI, MACD, Bollinger)
- `market_get_orderbook` — live order book depth (bid/ask walls, up to 400 levels)

**OKX instrument ID format:**
- Spot: `BTC-USDT`
- Perpetual swap: `BTC-USDT-SWAP` (use for funding rate, OI, swap trading)
- Futures: `BTC-USDT-240329` (expiry date suffix)

**If OKX Trade Kit is unavailable:**
```
Install OKX Trade Kit:
  npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
  okx config init
  okx-trade-mcp setup --client claude-code

Details: https://github.com/okx/agent-trade-kit
```

### Step 4: Format Results

Read `references/output-templates.md` for the exact template to use per query type:

| Query type | Template |
|------------|----------|
| Price / market check | Price check template |
| Technical analysis | Technical analysis template |
| Broad market overview | Market overview template |
| Multi-coin comparison | Comparison template |
| Derivatives / funding rate | Derivatives template |
| Top movers / gainers | Top movers template |

Always end every response with a **Quick Take** — 1-2 sentences in plain language. Never skip this.

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Search returns no results | Coin not found or misspelled | Report not found, ask user to clarify |
| CMC 400 "Invalid value" | Symbol format rejected | Strip special chars, try name search instead |
| Ambiguous symbol (PEPE → 32 results) | Multiple coins share same ticker | Pick lowest rank#, confirm with user if rank >500 |
| OKX 51001 "Instrument doesn't exist" | Coin not listed on OKX | Inform user; use CMC-only data |
| Tool fails or times out | Transient API error | Retry once; note which data is unavailable, proceed with other tools |
| Rate limited (429) | API rate limit exceeded | Inform user, suggest waiting, reduce concurrent tool calls |
| CMC MCP not configured | Missing API key or server config | Show setup guide above |
| CMC premium endpoint blocked | Free plan limitation | Switch to OKX fallback |
| Quotes tool fails | Critical for price queries | Try OKX `market_get_ticker` as fallback |
| Info tool fails | Background data unavailable | Note "Project info unavailable", provide what other tools return |

## Adapting to User Sophistication

- Casual ("how's bitcoin?" / "大饼多少了") — summary with key numbers, avoid jargon
- Technical ("what's the RSI on BTC?" / "日线怎么看") — detailed data with indicator values and signals
- Broad ("what's happening in crypto?" / "大盘怎么样") — global metrics, narratives, macro events
- Comparison ("BTC vs ETH") — side-by-side table with batch requests
- Trending ("what's pumping?" / "什麼幣漲得猛") — top movers from OKX tickers
- Derivatives ("funding rate?" / "资金费率") — OKX funding rate + open interest

## Chinese Slang Mappings

| Slang | Meaning | Action |
|-------|---------|--------|
| 大饼 / 饼 / 烧饼 | Bitcoin (BTC) | Search BTC |
| 二饼 | Ethereum (ETH) | Search ETH |
| 以太 | Ethereum (ETH) | Search ETH |
| 土狗 | Meme/shitcoins | Top movers, filter small caps |
| 恐贪指数 | Fear & Greed Index | Global metrics |
| 资金费率 | Funding rate | Derivatives flow |
| 大盘 | Overall market | Market overview |
| 日线 / 4H | Daily chart / 4-hour | TA with timeframe |

## Handling Trade Advice Queries

When users ask for trade advice (买什么 / 梭哈 / 给个单 / should I buy), do NOT give buy/sell recommendations. Instead:

1. Acknowledge the question
2. Provide relevant data: price, TA signals, funding rate, market sentiment
3. Say: "I can provide market data to help you make informed decisions, but I cannot give financial advice. Here's what the data shows:"

## Core Principles

1. **Search first** — always resolve names/symbols to CMC numeric IDs before calling other tools
2. **OKX for real-time, CMC for fundamentals** — OKX is the primary live data source; CMC adds market cap, dominance, and sentiment context
3. **Batch when possible** — use comma-separated IDs for multi-coin queries
4. **Graceful degradation** — if CMC premium tools fail, fall back to OKX data (prices, TA, top movers)
5. **Never fabricate data** — if a tool fails, say so; never invent prices or metrics
6. **Interpret for retail** — raw numbers without context are useless. Always add "What It Means" for non-obvious metrics
7. **Quick Take always** — end every data output with a 1-2 sentence plain-language summary

## Related Skills

- [alpha vantage](https://6ducklearn.com/skills/alpha-vantage/index.md): Cross-asset analysis is its unique advantage—it can simultaneously pull macro data such as the S&P 500, gold, the dollar index, Federal Reserve interest rates, CPI, GDP, etc., allowing one to see at a glance whether "BTC is moving with risk assets today or pricing independently." In conjunction with the OKX Trade Kit, Alpha Vantage is responsible for in-depth historical and macroeconomic context, while OKX provides real-time prices, funding rates, and order book data, with both complementing each other to form a complete analysis chain.
- [apex crypto intelligence](https://6ducklearn.com/skills/apex-crypto-intelligence/index.md): AI-driven multi-exchange cryptocurrency market analysis, arbitrage detection, and hedge fund-level trading reports using real-time data from major exchanges.
- [btc altcoin market pulse](https://6ducklearn.com/skills/btc-altcoin-market-pulse/index.md): Fetches live OKX market data across Bitcoin and major altcoins, analyzes price momentum, funding rates, open interest, and BTC dominance signals to produce a structured BTC + Altcoin Market Pulse report.
- [congress trades](https://6ducklearn.com/skills/congress-trades/index.md): Track U.S. Congress members' stock trades in real-time, making "smart political money" impossible to hide. Sync member trade disclosure data to a local SQLite database via the Quiver Quant API, allowing flexible queries by politician name, stock code, party, date range, and trade type. Large trades exceeding the configurable amount threshold (default $15,001) automatically trigger alerts, generating structured Alert files for real-time monitoring.
- [crypto research](https://6ducklearn.com/skills/crypto-research/index.md): A systematic cryptocurrency due diligence report, covering everything from price to holding distribution, from technical aspects to a red flag checklist, all in one go. Integrating the OKX Trade Kit (real-time prices, 70+ technical indicators, funding rates, open interest, order book depth) with CoinMarketCap (market cap, token economics, whale distribution, news sentiment), a seven-step research process is executed in parallel, covering market snapshots, technical analysis, derivatives data, project fundamentals, and recent news. The analysis framework specifically distinguishes between legitimate projects and Meme coins, evaluating key signals such as whale concentration, holder trends, 200-day moving average positions, and funding rate extremes, ultimately outputting a green flag/red flag checklist and low/medium/high/very high risk ratings.
- [hyperliquid analyzer](https://6ducklearn.com/skills/hyperliquid-analyzer/index.md): Analyze Hyperliquid market data to provide trading insights, covering six major analysis modes: capturing trading whales, automatic monitoring and push notifications of on-chain whale positions, order wall scanning, on-chain position analysis, HL and OKX funding fee sentiment analysis, and on-chain and off-chain price difference scanning. Use on-chain signals to assist your CEX trading.