back
loading skill details...
Professional market data and AI APIs via x402 micropayments — no API key, no signup, no subscription. Pay per call with USDC on Base. 215+ endpoints across 1...
---
name: claw402
description: >
Professional market data and AI APIs via x402 micropayments — no API key,
no signup, no subscription. Pay per call with USDC on Base. 215+ endpoints
across 12 provider groups: crypto market data (CoinAnk derivatives analytics,
nofxos.ai AI signals, CoinMarketCap quotes/listings/DEX/MCP), US stocks &
options (Alpaca, Polygon, Alpha Vantage), China A-shares (Tushare), forex &
global time-series (Twelve Data), and AI inference (GPT-4o, Claude, DeepSeek
V3/Reasoner, Qwen3-Max/Plus/Turbo/Flash/Coder/VL, embeddings, DALL-E).
One wallet, instant access to any paid API — no registration ever required.
version: 1.3.0
metadata:
openclaw:
emoji: "⚡"
homepage: https://claw402.ai
requires:
env: [WALLET_PRIVATE_KEY]
primaryEnv: WALLET_PRIVATE_KEY
install:
- kind: node
package: NoFxAiOS/claw402-js
bins: []
---
# ⚡ claw402 — Pay-Per-Call Market Data & AI APIs
> **215+ professional data endpoints. $0.001–$0.05 per call. One Base wallet.**
Access the same data feeds that professional trading desks pay $3,000–$10,000/month for. Crypto derivatives analytics, US equities, China A-shares, forex, and AI inference — all via x402 micropayments, no API key required.
---
## The Story — How $1,000 Became $800,000
Three months ago I had $1,000 in a Base wallet and an OpenClaw agent running on my laptop.
I asked the agent: *"Which coins have the most extreme funding rates right now?"*
The agent called `claw402`, paid $0.001 USDC, and came back with:
```
DOGE funding rate: +0.312%/8h (annualized 341%)
PEPE funding rate: +0.287%/8h
WIF funding rate: +0.241%/8h
```
I cross-checked: *"CVD? What are whales doing on HyperLiquid?"* Two more calls. $0.002 total.
```
CVD (last 6h): fading fast. Sellers pressing.
Top HyperLiquid whale: Short DOGE $2.1M, opened 2h ago.
```
I shorted DOGE. 40x. Three days later: **+80,000%**. That's $800,000 from $1,000. And less than $0.01 spent on data.
---
## When to Use This Skill
Use claw402 whenever the user asks about **any** of the following:
### 💰 CoinMarketCap — Quotes, Rankings & DEX
- Real-time crypto prices, market cap, volume, % changes (by symbol, slug, or CMC ID)
- Full cryptocurrency listings/rankings sorted by market cap, volume, or % change
- DEX trading pairs — on-chain liquidity, volume, price across Ethereum/BSC/Solana/Base/Arbitrum
- DEX token/pair search by keyword or contract address
- MCP endpoint with 12 AI tools: technical analysis, on-chain metrics, trending narratives, macro events
### 🔮 Crypto Derivatives & Market Structure
- Fear & greed index, altcoin season, market cycle indicators (AHR999, Pi Cycle, Puell)
- Fund flow & capital rotation by coin or exchange
- Liquidations — orders, heatmaps, clusters, aggregated history
- Open interest — real-time, aggregated chart, OI vs market cap
- Funding rates — current rankings, accumulated cost, weighted average, heatmap
- Long/short ratios — realtime, buy/sell, whale position, account level
- Whale activity — HyperLiquid top positions & actions, large block trades, big orders
- ETF flows — US Bitcoin ETF, US Ethereum ETF, Hong Kong crypto ETF
- AI trading signals — AI500 high-potential coins, AI300 quant rankings
- Taker flow / CVD — cumulative delta, buy/sell pressure across exchanges
- Order book depth history, liquidity heatmap
- Crypto news & flash alerts
### 📈 US Stocks & Options
- Real-time & historical quotes, trades, OHLCV bars for any US stock
- Market snapshots — full quote + bar + prev close in one call
- Top movers by % change, most active stocks by volume
- Financial news for any ticker
- Options chains — bars, quotes, snapshots for options contracts
- Corporate actions — dividends, splits
### 🇨🇳 China A-Shares
- Daily, weekly, monthly OHLCV for any A-share
- Stock basic info, trading calendar
- Fundamentals — income statement, balance sheet, cash flow, dividends
- Northbound capital flow (Hong Kong → mainland)
- Money flow, margin trading data, top lists, institutional trading
### 💹 US Stock Fundamentals & Technical Indicators
- Real-time quotes, daily/intraday/weekly/monthly OHLCV
- Company overview, earnings, income, balance sheet, cash flow
- Top gainers/losers, news sentiment
- RSI, MACD, Bollinger Bands, SMA, EMA
### 🌍 Forex, Metals & Global Time-Series
- EUR/USD, GBP/USD and any forex pair — tick or time-series
- Precious metals price and history — XAU/USD (gold), XAG/USD (silver)
- Global indices — list and real-time quotes
- Exchange rates, forex pairs reference, economic calendar
- Technical indicators — RSI, MACD, SMA, EMA, Bollinger Bands, ATR
### 🤖 AI Inference (GPT-4o, Claude, DeepSeek, Qwen, Embeddings, Images)
- OpenAI GPT-4o chat, GPT-4o-mini, embeddings (small + large), DALL-E images
- Anthropic Claude messages (standard, Haiku, Opus)
- DeepSeek V3 chat, DeepSeek-Reasoner (chain-of-thought), FIM completions
- Qwen3-Max, Qwen-Plus, Qwen-Turbo, Qwen-Flash, Qwen3-Coder-Plus, Qwen-VL (vision)
- Use to analyze market data your agent just fetched — chain calls in one session
---
## Cost & Privacy
| Item | Detail |
|------|--------|
| Crypto / stock data | **$0.001–$0.003 USDC** per call |
| CoinMarketCap quotes/DEX | **$0.015 USDC** per call |
| Twelvedata complex POST | **$0.005 USDC** per call |
| OpenAI GPT-4o chat | **$0.01 USDC** per call |
| OpenAI mini / embeddings | **$0.001–$0.005 USDC** per call |
| Claude messages | **$0.005–$0.015 USDC** per call |
| DeepSeek chat / reasoner | **$0.003–$0.005 USDC** per call |
| Qwen models | **$0.002–$0.010 USDC** per call |
| Payment chain | Base mainnet (Coinbase L2) |
| Payment method | EIP-3009 USDC transfer, signed locally |
| Key security | Private key **never transmitted** — signs locally only |
| API key required | **No** — wallet is your credential |
| Registration | **Never** |
Get USDC on Base: [bridge.base.org](https://bridge.base.org) · Testnet USDC: [faucet.circle.com](https://faucet.circle.com)
---
## Quick Start
### 1. Set your wallet key
```
WALLET_PRIVATE_KEY=0xYourBaseWalletPrivateKey
```
Your wallet must hold USDC on **Base mainnet**.
### 2. Query any GET endpoint
```bash
node scripts/query.mjs <endpoint-path> [key=value ...]
```
### 3. Call POST endpoints (AI / Twelvedata complex)
```bash
node scripts/query.mjs <endpoint-path> --post '<json-body>'
```
### 4. Read the result
The script prints `{ status, url, data }` as formatted JSON. Parse `data` for the actual payload.
---
## Query Examples
### Crypto Market Data
```bash
# --- Market Cycle & Sentiment ---
node scripts/query.mjs /api/v1/coinank/indicator/fear-greed
node scripts/query.mjs /api/v1/coinank/indicator/altcoin-season
node scripts/query.mjs /api/v1/coinank/indicator/btc-multiplier
node scripts/query.mjs /api/v1/coinank/indicator/ahr999
# --- Fund Flow ---
node scripts/query.mjs /api/v1/nofx/netflow/top-ranking limit=20 duration=1h
node scripts/query.mjs /api/v1/coinank/fund/realtime sortBy=h1net productType=SWAP
# --- Liquidations ---
node scripts/query.mjs /api/v1/coinank/liquidation/orders baseCoin=BTC
node scripts/query.mjs /api/v1/coinank/liquidation/liq-map symbol=BTCUSDT exchange=Binance interval=1d
# --- Open Interest ---
node scripts/query.mjs /api/v1/coinank/oi/all baseCoin=BTC
node scripts/query.mjs /api/v1/nofx/oi/top-ranking limit=20 duration=1h
# --- Funding Rates ---
node scripts/query.mjs /api/v1/coinank/funding-rate/current type=current
node scripts/query.mjs /api/v1/nofx/funding-rate/top limit=20
# --- Whale Tracking ---
node scripts/query.mjs /api/v1/coinank/hyper/top-position sortBy=pnl sortType=desc
node scripts/query.mjs /api/v1/coinank/hyper/top-action
# --- ETF Flows ---
node scripts/query.mjs /api/v1/coinank/etf/us-btc-inflow
node scripts/query.mjs /api/v1/coinank/etf/us-eth-inflow
# --- AI Signals ---
node scripts/query.mjs /api/v1/nofx/ai500/list limit=20
node scripts/query.mjs /api/v1/nofx/ai300/list limit=20
# --- CVD / Taker Flow ---
node scripts/query.mjs /api/v1/coinank/market-order/agg-cvd exchanges= symbol=BTCUSDT interval=1h size=24
# --- Price & Candles ---
node scripts/query.mjs /api/v1/coinank/price/last symbol=BTCUSDT exchange=Binance productType=SWAP
node scripts/query.mjs /api/v1/coinank/kline/lists symbol=BTCUSDT exchange=Binance interval=1h size=100
# --- News ---
node scripts/query.mjs /api/v1/coinank/news/list type=2 lang=en page=1 pageSize=10
```
### CoinMarketCap
```bash
# Real-time price for BTC and ETH (by symbol)
node scripts/query.mjs /api/v1/crypto/cmc/quotes symbol=BTC,ETH
# By CMC ID (1=BTC, 1027=ETH)
node scripts/query.mjs /api/v1/crypto/cmc/quotes id=1,1027
# Top 20 by market cap
node scripts/query.mjs /api/v1/crypto/cmc/listings limit=20 sort=market_cap
# Top DeFi tokens by volume
node scripts/query.mjs /api/v1/crypto/cmc/listings limit=20 tag=defi sort=volume_24h sort_dir=desc
# DEX pairs on Base with highest volume
node scripts/query.mjs /api/v1/crypto/cmc/dex/pairs network_slug=base sort=volume_24h sort_dir=desc limit=20
# Search PEPE on DEX
node scripts/query.mjs /api/v1/crypto/cmc/dex/search query=PEPE
# MCP — AI tools (12 tools available, uses JSON-RPC)
node scripts/query.mjs /api/v1/crypto/cmc/mcp --post '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_crypto_quotes_latest","arguments":{"symbol":"BTC,ETH"}},"id":1}'
```
### US Stocks — Alpaca
```bash
# Real-time quote
node scripts/query.mjs /api/v1/alpaca/quotes/latest symbols=AAPL,TSLA,MSFT
# Historical bars
node scripts/query.mjs /api/v1/alpaca/bars symbols=AAPL timeframe=1Day start=2024-01-01 limit=30
# Market snapshot (quote + bar + prev close)
node scripts/query.mjs /api/v1/alpaca/snapshots symbols=AAPL,TSLA
# Top movers
node scripts/query.mjs /api/v1/alpaca/movers top=10 market_type=stocks
# Most active stocks
node scripts/query.mjs /api/v1/alpaca/most-actives top=10
# Latest trade
node scripts/query.mjs /api/v1/alpaca/trades/latest symbols=AAPL
# Financial news
node scripts/query.mjs /api/v1/alpaca/news symbols=AAPL limit=10
# Options chain snapshot
node scripts/query.mjs /api/v1/alpaca/options/snapshots symbols=AAPL240119C00150000
```
### US Stocks — Polygon
```bash
# OHLCV bars
node scripts/query.mjs /api/v1/polygon/aggs/ticker stocks_ticker=AAPL multiplier=1 timespan=day from=2024-01-01 to=2024-01-31
# Previous close
node scripts/query.mjs /api/v1/polygon/prev-close stocks_ticker=AAPL
# Snapshot (full quote + bar)
node scripts/query.mjs /api/v1/polygon/snapshot/ticker stocks_ticker=AAPL
# Top gainers/losers
node scripts/query.mjs /api/v1/polygon/snapshot/gainers
node scripts/query.mjs /api/v1/polygon/snapshot/losers
# Company details
node scripts/query.mjs /api/v1/polygon/ticker-details ticker=AAPL
# Market status
node scripts/query.mjs /api/v1/polygon/market-status
# Technical indicators
node scripts/query.mjs /api/v1/polygon/rsi stock_ticker=AAPL timespan=day window=14
node scripts/query.mjs /api/v1/polygon/macd stocks_ticker=AAPL timespan=day
# Options chain
node scripts/query.mjs /api/v1/polygon/options/snapshot underlying_asset=AAPL
# News
node scripts/query.mjs /api/v1/polygon/ticker-news ticker=AAPL
```
### US Stocks — Alpha Vantage Fundamentals
```bash
# Real-time quote
node scripts/query.mjs /api/v1/stocks/us/quote symbol=AAPL
# Daily OHLCV
node scripts/query.mjs /api/v1/stocks/us/daily symbol=AAPL outputsize=compact
# Intraday
node scripts/query.mjs /api/v1/stocks/us/intraday symbol=AAPL interval=5min
# Company overview
node scripts/query.mjs /api/v1/stocks/us/overview symbol=AAPL
# Earnings history
node scripts/query.mjs /api/v1/stocks/us/earnings symbol=AAPL
# Financial statements
node scripts/query.mjs /api/v1/stocks/us/income symbol=AAPL
node scripts/query.mjs /api/v1/stocks/us/balance-sheet symbol=AAPL
node scripts/query.mjs /api/v1/stocks/us/cash-flow symbol=AAPL
# Top gainers/losers/most active
node scripts/query.mjs /api/v1/stocks/us/movers
# News & sentiment
node scripts/query.mjs /api/v1/stocks/us/news tickers=AAPL
# Technical indicators
node scripts/query.mjs /api/v1/stocks/us/rsi symbol=AAPL interval=daily time_period=14
node scripts/query.mjs /api/v1/stocks/us/macd symbol=AAPL interval=daily
node scripts/query.mjs /api/v1/stocks/us/bbands symbol=AAPL interval=daily time_period=20
```
### China A-Shares — Tushare
```bash
# Stock list (all listed stocks)
node scripts/query.mjs /api/v1/stocks/cn/stock-basic list_status=L
# Daily OHLCV
node scripts/query.mjs /api/v1/stocks/cn/daily ts_code=000001.SZ start_date=20240101 end_date=20240131
# Trading calendar
node scripts/query.mjs /api/v1/stocks/cn/trade-cal start_date=20240101 end_date=20240131
# Northbound capital flow
node scripts/query.mjs /api/v1/stocks/cn/northbound trade_date=20240315
# Money flow
node scripts/query.mjs /api/v1/stocks/cn/moneyflow ts_code=000001.SZ start_date=20240101
# Margin trading data
node scripts/query.mjs /api/v1/stocks/cn/margin ts_code=000001.SZ start_date=20240101
# Top list (dragon tiger list)
node scripts/query.mjs /api/v1/stocks/cn/top-list trade_date=20240315
# Fundamentals
node scripts/query.mjs /api/v1/stocks/cn/income ts_code=000001.SZ period=20231231
node scripts/query.mjs /api/v1/stocks/cn/balance-sheet ts_code=000001.SZ period=20231231
```
### Forex & Global Time-Series — Twelve Data
```bash
# Time series — EUR/USD hourly
node scripts/query.mjs /api/v1/twelvedata/time-series symbol=EUR/USD interval=1h outputsize=50
# Real-time price
node scripts/query.mjs /api/v1/twelvedata/price symbol=BTC/USD
node scripts/query.mjs /api/v1/twelvedata/price symbol=XAU/USD
# Exchange rate
node scripts/query.mjs /api/v1/twelvedata/exchange-rate symbol=USD/JPY
# Technical indicators
node scripts/query.mjs /api/v1/twelvedata/indicator/rsi symbol=AAPL interval=1day time_period=14 outputsize=10
node scripts/query.mjs /api/v1/twelvedata/indicator/macd symbol=EUR/USD interval=1h
node scripts/query.mjs /api/v1/twelvedata/indicator/bbands symbol=AAPL interval=1day
# Precious metals
node scripts/query.mjs /api/v1/twelvedata/metals/price symbol=XAU/USD
node scripts/query.mjs /api/v1/twelvedata/metals/time-series symbol=XAU/USD interval=1day
# Global indices
node scripts/query.mjs /api/v1/twelvedata/indices/list
node scripts/query.mjs /api/v1/twelvedata/indices/quote symbol=SPX
# Economic calendar
node scripts/query.mjs /api/v1/twelvedata/economic-calendar
# Available forex pairs
node scripts/query.mjs /api/v1/twelvedata/forex-pairs
```
### AI Inference — OpenAI & Anthropic (POST)
```bash
# GPT-4o chat
node scripts/query.mjs /api/v1/ai/openai/chat --post '{"model":"gpt-4o","messages":[{"role":"user","content":"Analyze: BTC funding rate is extreme positive, CVD fading, whale just shorted. What does this mean?"}]}'
# GPT-4o-mini (cheaper)
node scripts/query.mjs /api/v1/ai/openai/chat/mini --post '{"messages":[{"role":"user","content":"Summarize AAPL earnings in 3 bullet points."}]}'
# Embeddings
node scripts/query.mjs /api/v1/ai/openai/embeddings --post '{"input":"crypto market sentiment","model":"text-embedding-3-small"}'
# List available OpenAI models
node scripts/query.mjs /api/v1/ai/openai/models
# Claude Sonnet (standard, balanced)
node scripts/query.mjs /api/v1/ai/anthropic/messages --post '{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":[{"role":"user","content":"What trading setup does extreme funding + CVD divergence suggest?"}]}'
# Claude Haiku (fast, cheap)
node scripts/query.mjs /api/v1/ai/anthropic/messages/haiku --post '{"max_tokens":256,"messages":[{"role":"user","content":"One-sentence summary of BTC ETF flows today."}]}'
# Claude Opus (deepest reasoning)
node scripts/query.mjs /api/v1/ai/anthropic/messages/opus --post '{"max_tokens":2048,"messages":[{"role":"user","content":"Full macro analysis: ETF inflows strong, funding extreme, CVD diverging..."}]}'
```
### AI Inference — DeepSeek (POST)
```bash
# DeepSeek-Chat V3 (general tasks, fast, cheap)
node scripts/query.mjs /api/v1/ai/deepseek/chat --post '{"model":"deepseek-chat","messages":[{"role":"user","content":"Analyze: BTC funding rate extreme, CVD fading. What does this mean?"}]}'
# DeepSeek-Reasoner (chain-of-thought, best for complex analysis)
node scripts/query.mjs /api/v1/ai/deepseek/chat/reasoner --post '{"messages":[{"role":"user","content":"Given extreme funding rates + whale short + CVD divergence, what is the high-conviction trade?"}]}'
# FIM / code completions (beta)
node scripts/query.mjs /api/v1/ai/deepseek/completions --post '{"model":"deepseek-chat","prompt":"Summarize this market data: ","suffix":"","max_tokens":256}'
# List available DeepSeek models
node scripts/query.mjs /api/v1/ai/deepseek/models
```
### AI Inference — Qwen (POST)
```bash
# Qwen3-Max (flagship, most powerful — same cost as GPT-4o)
node scripts/query.mjs /api/v1/ai/qwen/chat/max --post '{"messages":[{"role":"user","content":"Full macro analysis: ETF inflows strong, funding extreme, CVD diverging..."}]}'
# Qwen-Plus (best value — great for most analysis tasks)
node scripts/query.mjs /api/v1/ai/qwen/chat/plus --post '{"messages":[{"role":"user","content":"Summarize the top 5 signals from this BTC market data."}]}'
# Qwen-Turbo (fast, cheap — good for quick summaries)
node scripts/query.mjs /api/v1/ai/qwen/chat/turbo --post '{"messages":[{"role":"user","content":"One-sentence summary of these ETF flows."}]}'
# Qwen-Flash (ultra-low latency, cheapest Qwen model)
node scripts/query.mjs /api/v1/ai/qwen/chat/flash --post '{"messages":[{"role":"user","content":"Is DOGE funding rate bullish or bearish right now?"}]}'
# Qwen3-Coder-Plus (code generation, analysis scripts)
node scripts/query.mjs /api/v1/ai/qwen/chat/coder --post '{"messages":[{"role":"user","content":"Write a Python script to calculate position size given 2% risk on $10,000."}]}'
# Qwen-VL-Plus (vision — analyze charts, images)
node scripts/query.mjs /api/v1/ai/qwen/chat/vl --post '{"messages":[{"role":"user","content":[{"type":"text","text":"Describe this chart pattern"},{"type":"image_url","image_url":{"url":"data:image/png;base64,..."}}]}]}'
```
**Always** run the command, then format the `data` field clearly for the user — tables, bullet points, or a brief narrative summary.
---
## Power Pattern: Chain Multiple Calls
The real power of claw402 is combining data sources in one agent session:
```bash
# Step 1: Find crowded trades ($0.001)
node scripts/query.mjs /api/v1/nofx/funding-rate/top limit=20
# Step 2: Confirm with CVD ($0.001)
node scripts/query.mjs /api/v1/coinank/market-order/agg-cvd exchanges= symbol=DOGEUSDT interval=1h size=6
# Step 3: Check whale positioning ($0.001)
node scripts/query.mjs /api/v1/coinank/hyper/top-position sortBy=value sortType=desc
# Step 4: Cross-reference with US macro ($0.001)
node scripts/query.mjs /api/v1/alpaca/movers top=10 market_type=stocks
# Step 5: Let AI synthesize the analysis (pick any model)
# Cheapest: Qwen-Flash $0.002 or DeepSeek-Chat $0.003
node scripts/query.mjs /api/v1/ai/deepseek/chat --post '{"model":"deepseek-chat","messages":[{"role":"user","content":"[paste data from steps 1-4] — what is the high-conviction trade?"}]}'
# Or for chain-of-thought reasoning: DeepSeek-Reasoner $0.005
node scripts/query.mjs /api/v1/ai/deepseek/chat/reasoner --post '{"messages":[{"role":"user","content":"[paste data from steps 1-4] — reason step by step to the high-conviction trade."}]}'
```
**Total cost: ~$0.007–$0.014 USDC.** Bloomberg Terminal equivalent: $2,000/month.
---
## Natural Language → Command Mapping
### CoinMarketCap
| User says | Command |
|-----------|---------|
| "BTC price?" (CMC) | `/api/v1/crypto/cmc/quotes symbol=BTC` |
| "ETH market cap?" | `/api/v1/crypto/cmc/quotes symbol=ETH` |
| "Top 50 coins by market cap?" | `/api/v1/crypto/cmc/listings limit=50` |
| "Top gainers today?" (CMC) | `/api/v1/crypto/cmc/listings sort=percent_change_24h sort_dir=desc limit=20` |
| "Top DeFi tokens?" | `/api/v1/crypto/cmc/listings tag=defi sort=market_cap` |
| "DEX pairs on Solana?" | `/api/v1/crypto/cmc/dex/pairs network_slug=solana` |
| "Search for PEPE on DEX?" | `/api/v1/crypto/cmc/dex/search query=PEPE` |
| "Find contract on Base?" | `/api/v1/crypto/cmc/dex/pairs network_slug=base contract_address=0x...` |
| "Trending crypto narratives?" | `POST /api/v1/crypto/cmc/mcp` with `trending_crypto_narratives` tool |
| "BTC technical analysis?" (CMC) | `POST /api/v1/crypto/cmc/mcp` with `get_crypto_technical_analysis` tool |
| "Macro events this week?" | `POST /api/v1/crypto/cmc/mcp` with `get_upcoming_macro_events` tool |
### Crypto (CoinAnk / nofxos.ai)
| User says | Command |
|-----------|---------|
| "Fear & greed index?" | `/api/v1/coinank/indicator/fear-greed` |
| "Altcoin season?" | `/api/v1/coinank/indicator/altcoin-season` |
| "Bitcoin cycle position?" | `/api/v1/coinank/indicator/btc-multiplier`, `ahr999` |
| "Which coins have extreme funding rates?" | `/api/v1/coinank/funding-rate/current type=current` |
| "Most negative funding rates?" | `/api/v1/nofx/funding-rate/low limit=20` |
| "Which coins have the most capital inflows?" | `/api/v1/nofx/netflow/top-ranking limit=20 duration=1h` |
| "Fund flow for BTC?" | `/api/v1/coinank/fund/realtime sortBy=h1net productType=SWAP` |
| "Recent large liquidations?" | `/api/v1/coinank/liquidation/orders baseCoin=BTC` |
| "BTC liquidation map / price clusters?" | `/api/v1/coinank/liquidation/liq-map symbol=BTCUSDT exchange=Binance interval=1d` |
| "BTC open interest?" | `/api/v1/coinank/oi/all baseCoin=BTC` |
| "Biggest OI increases?" | `/api/v1/nofx/oi/top-ranking limit=20 duration=1h` |
| "BTC long/short ratio?" | `/api/v1/coinank/longshort/realtime baseCoin=BTC interval=1h` |
| "Whale positions on HyperLiquid?" | `/api/v1/coinank/hyper/top-position sortBy=pnl sortType=desc` |
| "Recent whale trades?" | `/api/v1/coinank/hyper/top-action` |
| "Bitcoin ETF inflows today?" | `/api/v1/coinank/etf/us-btc-inflow` |
| "Ethereum ETF flows?" | `/api/v1/coinank/etf/us-eth-inflow` |
| "Top AI-picked coins?" | `/api/v1/nofx/ai500/list limit=20` |
| "CVD for BTC?" | `/api/v1/coinank/market-order/agg-cvd exchanges= symbol=BTCUSDT interval=1h size=24` |
| "Is buying pressure real?" | `/api/v1/coinank/market-order/agg-cvd` |
| "BTC price?" | `/api/v1/coinank/price/last symbol=BTCUSDT exchange=Binance productType=SWAP` |
| "Top gainers today?" | `/api/v1/nofx/price/ranking duration=24h` |
| "Trending on Upbit?" | `/api/v1/nofx/upbit/hot limit=20` |
| "Latest crypto news?" | `/api/v1/coinank/news/list type=2 lang=en page=1 pageSize=10` |
### US Stocks
| User says | Command |
|-----------|---------|
| "AAPL stock price right now?" | `/api/v1/alpaca/quotes/latest symbols=AAPL` |
| "AAPL daily chart last month?" | `/api/v1/alpaca/bars symbols=AAPL timeframe=1Day start=2024-01-01` |
| "Full AAPL snapshot?" | `/api/v1/alpaca/snapshots symbols=AAPL` |
| "Top movers today?" | `/api/v1/alpaca/movers top=10 market_type=stocks` |
| "Most traded stocks?" | `/api/v1/alpaca/most-actives top=10` |
| "AAPL OHLCV bars (Polygon)?" | `/api/v1/polygon/aggs/ticker stocks_ticker=AAPL multiplier=1 timespan=day from=... to=...` |
| "Market open today?" | `/api/v1/polygon/market-status` |
| "AAPL RSI?" | `/api/v1/polygon/rsi stock_ticker=AAPL timespan=day window=14` |
| "AAPL options chain?" | `/api/v1/polygon/options/snapshot underlying_asset=AAPL` |
| "AAPL stock overview/fundamentals?" | `/api/v1/stocks/us/overview symbol=AAPL` |
| "AAPL earnings history?" | `/api/v1/stocks/us/earnings symbol=AAPL` |
| "AAPL income statement?" | `/api/v1/stocks/us/income symbol=AAPL` |
| "AAPL MACD?" | `/api/v1/stocks/us/macd symbol=AAPL interval=daily` |
| "Top gainers/losers today?" | `/api/v1/stocks/us/movers` |
| "AAPL news sentiment?" | `/api/v1/stocks/us/news tickers=AAPL` |
### China A-Shares
| User says | Command |
|-----------|---------|
| "List all A-share stocks?" | `/api/v1/stocks/cn/stock-basic list_status=L` |
| "000001.SZ daily chart?" | `/api/v1/stocks/cn/daily ts_code=000001.SZ start_date=20240101 end_date=20240131` |
| "Trading calendar for January?" | `/api/v1/stocks/cn/trade-cal start_date=20240101 end_date=20240131` |
| "Northbound flows today?" | `/api/v1/stocks/cn/northbound trade_date=20240315` |
| "Money flow for 000001?" | `/api/v1/stocks/cn/moneyflow ts_code=000001.SZ start_date=20240101` |
| "Dragon tiger list?" | `/api/v1/stocks/cn/top-list trade_date=20240315` |
| "Margin data?" | `/api/v1/stocks/cn/margin ts_code=000001.SZ start_date=20240101` |
### Forex & Global
| User says | Command |
|-----------|---------|
| "EUR/USD rate?" | `/api/v1/twelvedata/price symbol=EUR/USD` |
| "EUR/USD hourly chart?" | `/api/v1/twelvedata/time-series symbol=EUR/USD interval=1h outputsize=50` |
| "Gold price?" | `/api/v1/twelvedata/metals/price symbol=XAU/USD` |
| "Gold daily chart?" | `/api/v1/twelvedata/metals/time-series symbol=XAU/USD interval=1day` |
| "S&P 500 index level?" | `/api/v1/twelvedata/indices/quote symbol=SPX` |
| "What global indices are available?" | `/api/v1/twelvedata/indices/list` |
| "Economic calendar this week?" | `/api/v1/twelvedata/economic-calendar` |
| "EUR/USD RSI?" | `/api/v1/twelvedata/indicator/rsi symbol=EUR/USD interval=1h time_period=14` |
| "Available forex pairs?" | `/api/v1/twelvedata/forex-pairs` |
### AI Inference
| User says | Command |
|-----------|---------|
| "Analyze this market data with AI" | `POST /api/v1/ai/openai/chat` with `gpt-4o` |
| "Quick AI summary (cheap)" | `POST /api/v1/ai/openai/chat/mini` or `POST /api/v1/ai/anthropic/messages/haiku` |
| "Deep AI analysis" | `POST /api/v1/ai/anthropic/messages/opus` |
| "Embed this text" | `POST /api/v1/ai/openai/embeddings` |
| "Generate an image" | `POST /api/v1/ai/openai/images` |
| "List OpenAI models" | `/api/v1/ai/openai/models` |
| "Use DeepSeek to analyze" | `POST /api/v1/ai/deepseek/chat` |
| "Step-by-step reasoning / think through this" | `POST /api/v1/ai/deepseek/chat/reasoner` |
| "List DeepSeek models" | `/api/v1/ai/deepseek/models` |
| "Use Qwen (Chinese AI)" | `POST /api/v1/ai/qwen/chat/plus` |
| "Cheapest Qwen model" | `POST /api/v1/ai/qwen/chat/flash` |
| "Qwen flagship / best quality" | `POST /api/v1/ai/qwen/chat/max` |
| "Qwen coding / code generation" | `POST /api/v1/ai/qwen/chat/coder` |
| "Analyze a chart image with AI" | `POST /api/v1/ai/qwen/chat/vl` (vision) |
---
## Complete Endpoint Reference
### 💰 CoinMarketCap — $0.015/call
| Endpoint | Method | Description | Key Params |
|----------|--------|-------------|------------|
| `/api/v1/crypto/cmc/quotes` | GET | Real-time crypto quotes (price, market cap, volume, % change) | `symbol`, `id`, `slug`, `convert`, `aux` |
| `/api/v1/crypto/cmc/listings` | GET | Crypto rankings (default by market cap) | `limit`, `sort`, `sort_dir`, `tag`, `cryptocurrency_type`, `price_min/max`, `market_cap_min/max` |
| `/api/v1/crypto/cmc/dex/pairs` | GET | DEX trading pair quotes by network or contract | `network_slug`, `contract_address`, `sort`, `limit`, `liquidity_min`, `volume_24h_min` |
| `/api/v1/crypto/cmc/dex/search` | GET | Search DEX tokens/pairs by keyword or contract | `query` (required), `network` |
| `/api/v1/crypto/cmc/mcp` | POST | CoinMarketCap MCP server — 12 AI tools | JSON-RPC body with `method`, `params.name`, `params.arguments` |
**CMC MCP tools:** `get_crypto_quotes_latest` · `search_cryptos` · `get_crypto_info` · `get_crypto_technical_analysis` · `get_crypto_marketcap_technical_analysis` · `get_crypto_metrics` · `get_global_metrics_latest` · `get_global_crypto_derivatives_metrics` · `trending_crypto_narratives` · `get_upcoming_macro_events` · `get_crypto_latest_news` · `search_crypto_info`
**`network_slug` values:** `ethereum` `bsc` `solana` `base` `arbitrum` `polygon` `avalanche`
---
### 🤖 AI Trading Signals (Nofxos) — $0.001/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/nofx/ai500/list` | AI500 high-potential coins (score > 70) | `limit` |
| `/api/v1/nofx/ai500/stats` | AI500 index statistics | — |
| `/api/v1/nofx/ai300/list` | AI300 quant model rankings | `limit` |
| `/api/v1/nofx/ai300/stats` | AI300 statistics | — |
| `/api/v1/nofx/netflow/top-ranking` | Top net capital inflow coins | `limit`, `duration`, `type` |
| `/api/v1/nofx/netflow/low-ranking` | Top net capital outflow coins | `limit`, `duration`, `type` |
| `/api/v1/nofx/oi/top-ranking` | Biggest OI increase coins | `limit`, `duration` |
| `/api/v1/nofx/oi/low-ranking` | Biggest OI decrease coins | `limit`, `duration` |
| `/api/v1/nofx/price/ranking` | Price change rankings | `duration` |
| `/api/v1/nofx/funding-rate/top` | Highest funding rate coins | `limit` |
| `/api/v1/nofx/funding-rate/low` | Most negative funding rate coins | `limit` |
| `/api/v1/nofx/upbit/hot` | Upbit hot coins by volume | `limit` |
| `/api/v1/nofx/upbit/netflow/top-ranking` | Upbit net inflow rankings | `limit`, `duration` |
| `/api/v1/nofx/upbit/netflow/low-ranking` | Upbit net outflow rankings | `limit`, `duration` |
| `/api/v1/nofx/query-rank/list` | Most searched coin rankings | `limit` |
**`duration` values:** `5m` `15m` `1h` `4h` `24h`
---
### 📈 Crypto Market Data (Coinank) — $0.001–$0.003/call
#### Price & Candlesticks
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/price/last` | Real-time latest price | `symbol`, `exchange`, `productType` |
| `/api/v1/coinank/kline/lists` | OHLCV candlestick data | `symbol`, `exchange`, `interval`, `size`, `endTime` |
#### ETF Flows
| Endpoint | Description |
|----------|-------------|
| `/api/v1/coinank/etf/us-btc` | US Bitcoin ETF list (IBIT, FBTC, ARKB, etc.) |
| `/api/v1/coinank/etf/us-eth` | US Ethereum ETF list |
| `/api/v1/coinank/etf/us-btc-inflow` | US BTC ETF historical net inflow |
| `/api/v1/coinank/etf/us-eth-inflow` | US ETH ETF historical net inflow |
| `/api/v1/coinank/etf/hk-inflow` | Hong Kong crypto ETF net inflow |
#### Fund Flow
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/fund/realtime` | Real-time fund flow rankings | `sortBy` (h1net/h4net/h24net), `productType`, `size` |
| `/api/v1/coinank/fund/history` | Historical fund flow by coin | `baseCoin`, `interval`, `size`, `endTime` |
#### Open Interest
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/oi/all` | Real-time OI by exchange | `baseCoin` |
| `/api/v1/coinank/oi/agg-chart` | Aggregated OI history | `baseCoin`, `exchange`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/oi/symbol-chart` | OI history by trading pair | `exchange`, `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/oi/kline` | OI candlestick | `exchange`, `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/oi/vs-market-cap-hist` | OI / market cap ratio history | `baseCoin`, `interval`, `size`, `endTime` |
#### Liquidations
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/liquidation/orders` | Recent liquidation orders | `baseCoin`, `exchange`, `side`, `amount`, `endTime` |
| `/api/v1/coinank/liquidation/intervals` | Liquidation stats by period | `baseCoin` |
| `/api/v1/coinank/liquidation/agg-history` | Aggregated liquidation history | `baseCoin`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/liquidation/liq-map` | Liquidation price-level clusters | `symbol`, `exchange`, `interval` |
| `/api/v1/coinank/liquidation/heat-map` | Liquidation heatmap | `exchange`, `symbol`, `interval` |
#### Long/Short Ratios
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/longshort/realtime` | Real-time L/S ratio by exchange | `baseCoin`, `interval` |
| `/api/v1/coinank/longshort/buy-sell` | Global buy-sell L/S history | `baseCoin`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/longshort/person` | Account-level L/S ratio | `exchange`, `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/longshort/position` | Whale position-level L/S | `exchange`, `symbol`, `interval`, `size`, `endTime` |
#### Funding Rates
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/funding-rate/current` | Real-time funding rate rankings | `type` (current/day/week/month/year) |
| `/api/v1/coinank/funding-rate/accumulated` | Accumulated funding cost | `type` |
| `/api/v1/coinank/funding-rate/hist` | Historical funding rates | `baseCoin`, `exchangeType`, `size`, `endTime` |
| `/api/v1/coinank/funding-rate/weighted` | Weighted average funding rate | `baseCoin`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/funding-rate/heatmap` | Funding rate heatmap | `type` (openInterest/marketCap), `interval` |
#### Whale Activity
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/hyper/top-position` | HyperLiquid whale positions | `sortBy`, `sortType`, `page`, `size` |
| `/api/v1/coinank/hyper/top-action` | HyperLiquid whale trade actions | — |
| `/api/v1/coinank/trades/large` | Large block trades | `symbol`, `productType`, `amount`, `size`, `endTime` |
| `/api/v1/coinank/big-order/list` | Large limit orders | `symbol`, `exchangeType`, `size`, `amount`, `side` |
#### Taker Flow / CVD
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/market-order/cvd` | CVD for single pair | `exchange`, `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/market-order/agg-cvd` | Aggregated CVD cross-exchange | `exchanges` (empty=all), `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/market-order/buy-sell-value` | Taker buy/sell value USD | `exchange`, `symbol`, `interval`, `size`, `endTime` |
| `/api/v1/coinank/market-order/agg-buy-sell-value` | Aggregated buy/sell value | `exchanges`, `symbol`, `interval`, `size`, `endTime` |
#### Rankings & Screeners
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/rank/screener` | Multi-dimensional screener | `interval` |
| `/api/v1/coinank/rank/oi` | OI rankings | `sortBy`, `sortType`, `size` |
| `/api/v1/coinank/rank/liquidation` | Liquidation rankings | `sortBy`, `sortType`, `size` |
| `/api/v1/coinank/rank/volume` | Volume rankings | `sortBy`, `sortType` |
| `/api/v1/coinank/rank/price` | Price change rankings | `sortBy`, `sortType` |
| `/api/v1/coinank/rsi/list` | RSI screener | `interval` (1H/4H/1D — uppercase) |
#### Market Cycle Indicators
| Endpoint | Description |
|----------|-------------|
| `/api/v1/coinank/indicator/fear-greed` | Crypto fear & greed index |
| `/api/v1/coinank/indicator/altcoin-season` | Altcoin Season Index |
| `/api/v1/coinank/indicator/btc-multiplier` | BTC 2-year MA multiplier |
| `/api/v1/coinank/indicator/ahr999` | AHR999 accumulation indicator |
| `/api/v1/coinank/indicator/puell-multiple` | Puell Multiple |
| `/api/v1/coinank/indicator/ma-heatmap` | 200-week MA heatmap |
| `/api/v1/coinank/indicator/market-cap-rank` | Coin market cap share |
#### News
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/coinank/news/list` | News & flash alerts | `type` (1=flash, 2=news), `lang` (zh/en), `page`, `pageSize` |
| `/api/v1/coinank/news/detail` | Full article by ID | `id` |
---
### 📊 US Stocks — Alpaca Markets — $0.001–$0.003/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/alpaca/quotes/latest` | Real-time quotes | `symbols`, `feed`, `currency` |
| `/api/v1/alpaca/quotes/history` | Historical tick quotes | `symbols`, `start`, `end`, `limit`, `feed` |
| `/api/v1/alpaca/bars/latest` | Latest OHLCV bar | `symbols`, `feed`, `currency` |
| `/api/v1/alpaca/bars` | Historical OHLCV bars | `symbols`, `timeframe`, `start`, `end`, `limit`, `adjustment` |
| `/api/v1/alpaca/trades/latest` | Real-time latest trade | `symbols`, `feed` |
| `/api/v1/alpaca/trades/history` | Historical trades | `symbols`, `start`, `end`, `limit`, `feed` |
| `/api/v1/alpaca/snapshots` | Full snapshot (multi-symbol) | `symbols`, `feed` |
| `/api/v1/alpaca/snapshot` | Full snapshot (single symbol) | `symbols`, `feed` |
| `/api/v1/alpaca/movers` | Top movers by % change | `top`, `market_type` |
| `/api/v1/alpaca/most-actives` | Most active by volume | `top`, `market_type` |
| `/api/v1/alpaca/news` | Financial news | `symbols`, `start`, `end`, `limit` |
| `/api/v1/alpaca/corporate-actions` | Dividends, splits, etc. | `symbols`, `types`, `start`, `end` |
| `/api/v1/alpaca/options/bars` | Options OHLCV bars | `symbols`, `timeframe`, `start`, `end` |
| `/api/v1/alpaca/options/quotes/latest` | Options latest quotes | `symbols`, `feed` |
| `/api/v1/alpaca/options/snapshots` | Options chain snapshots | `symbols`, `feed` |
**`timeframe` values:** `1Min` `5Min` `15Min` `1Hour` `1Day`
**`market_type` values:** `stocks` `crypto`
---
### 📉 US Stocks — Polygon — $0.001–$0.003/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/polygon/aggs/ticker` | OHLCV bars | `stocks_ticker`, `multiplier`, `timespan`, `from`, `to` |
| `/api/v1/polygon/aggs/grouped` | Grouped daily bars | `date`, `adjusted` |
| `/api/v1/polygon/prev-close` | Previous session close | `stocks_ticker` |
| `/api/v1/polygon/snapshot/ticker` | Full ticker snapshot | `stocks_ticker` |
| `/api/v1/polygon/snapshot/all` | All tickers snapshot | `tickers` |
| `/api/v1/polygon/snapshot/gainers` | Top daily gainers | — |
| `/api/v1/polygon/snapshot/losers` | Top daily losers | — |
| `/api/v1/polygon/trades` | Recent trades | `stocks_ticker` |
| `/api/v1/polygon/last-trade` | Last trade | `stocks_ticker` |
| `/api/v1/polygon/quotes` | Recent quotes | `stocks_ticker` |
| `/api/v1/polygon/last-quote` | Last NBBO quote | `stocks_ticker` |
| `/api/v1/polygon/ticker-details` | Company details | `ticker` |
| `/api/v1/polygon/ticker-news` | Company news | `ticker` |
| `/api/v1/polygon/tickers` | Ticker search | `ticker`, `type`, `market` |
| `/api/v1/polygon/market-status` | US market open/closed | — |
| `/api/v1/polygon/market-holidays` | Market holidays | — |
| `/api/v1/polygon/exchanges` | Exchange list | — |
| `/api/v1/polygon/sma` | SMA indicator | `stocks_ticker`, `timespan`, `window` |
| `/api/v1/polygon/ema` | EMA indicator | `stocks_ticker`, `timespan`, `window` |
| `/api/v1/polygon/rsi` | RSI indicator | `stock_ticker`, `timespan`, `window` |
| `/api/v1/polygon/macd` | MACD indicator | `stocks_ticker`, `timespan` |
| `/api/v1/polygon/options/contracts` | Options contracts list | `underlying_asset`, `contract_type`, `expiration_date` |
| `/api/v1/polygon/options/contract-details` | Single contract details | `options_ticker` |
| `/api/v1/polygon/options/snapshot` | Options chain snapshot | `underlying_asset` |
| `/api/v1/polygon/options/snapshot/contract` | Single option snapshot | `options_ticker` |
**`timespan` values:** `minute` `hour` `day` `week` `month` `quarter` `year`
---
### 🏢 US Fundamentals — Alpha Vantage — $0.001–$0.003/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/stocks/us/quote` | Real-time quote | `symbol` |
| `/api/v1/stocks/us/search` | Symbol search | `keywords` |
| `/api/v1/stocks/us/daily` | Daily OHLCV | `symbol`, `outputsize` (compact/full) |
| `/api/v1/stocks/us/daily-adjusted` | Adjusted daily OHLCV | `symbol`, `outputsize` |
| `/api/v1/stocks/us/intraday` | Intraday OHLCV | `symbol`, `interval` (1min/5min/15min/30min/60min), `outputsize` |
| `/api/v1/stocks/us/weekly` | Weekly OHLCV | `symbol` |
| `/api/v1/stocks/us/monthly` | Monthly OHLCV | `symbol` |
| `/api/v1/stocks/us/overview` | Company fundamentals | `symbol` |
| `/api/v1/stocks/us/earnings` | Quarterly & annual earnings | `symbol` |
| `/api/v1/stocks/us/income` | Income statement | `symbol` |
| `/api/v1/stocks/us/balance-sheet` | Balance sheet | `symbol` |
| `/api/v1/stocks/us/cash-flow` | Cash flow statement | `symbol` |
| `/api/v1/stocks/us/movers` | Top gainers/losers/most active | — |
| `/api/v1/stocks/us/news` | News & sentiment | `tickers`, `topics` |
| `/api/v1/stocks/us/rsi` | RSI | `symbol`, `interval`, `time_period` |
| `/api/v1/stocks/us/macd` | MACD | `symbol`, `interval` |
| `/api/v1/stocks/us/bbands` | Bollinger Bands | `symbol`, `interval`, `time_period` |
| `/api/v1/stocks/us/sma` | SMA | `symbol`, `interval`, `time_period` |
| `/api/v1/stocks/us/ema` | EMA | `symbol`, `interval`, `time_period` |
---
### 🇨🇳 China A-Shares — Tushare — $0.001–$0.003/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/stocks/cn/stock-basic` | Listed stock directory | `list_status` (L/D/P), `ts_code` |
| `/api/v1/stocks/cn/daily` | Daily OHLCV | `ts_code`, `start_date`, `end_date` |
| `/api/v1/stocks/cn/weekly` | Weekly OHLCV | `ts_code`, `start_date`, `end_date` |
| `/api/v1/stocks/cn/monthly` | Monthly OHLCV | `ts_code`, `start_date`, `end_date` |
| `/api/v1/stocks/cn/daily-basic` | Daily valuation metrics | `ts_code`, `trade_date` |
| `/api/v1/stocks/cn/trade-cal` | Trading calendar | `start_date`, `end_date`, `is_open` |
| `/api/v1/stocks/cn/income` | Income statement | `ts_code`, `period` |
| `/api/v1/stocks/cn/balance-sheet` | Balance sheet | `ts_code`, `period` |
| `/api/v1/stocks/cn/cash-flow` | Cash flow statement | `ts_code`, `period` |
| `/api/v1/stocks/cn/dividend` | Dividend history | `ts_code` |
| `/api/v1/stocks/cn/northbound` | Northbound capital flow | `trade_date` |
| `/api/v1/stocks/cn/moneyflow` | Money flow (net in/out) | `ts_code`, `start_date` |
| `/api/v1/stocks/cn/margin` | Margin trading summary | `ts_code`, `start_date`, `end_date` |
| `/api/v1/stocks/cn/margin-detail` | Margin trading detail | `ts_code`, `trade_date` |
| `/api/v1/stocks/cn/top-list` | Dragon Tiger List (top traders) | `trade_date` |
| `/api/v1/stocks/cn/top-inst` | Institutional top list | `trade_date`, `ts_code` |
**Date format:** `YYYYMMDD` (e.g., `20240315`)
**Stock code format:** `000001.SZ` (Shenzhen) · `600000.SH` (Shanghai)
---
### 🌍 Forex & Global — Twelve Data — $0.001–$0.005/call
| Endpoint | Description | Key Params |
|----------|-------------|------------|
| `/api/v1/twelvedata/time-series` | Time series (OHLCV) | `symbol`, `interval`, `outputsize` |
| `/api/v1/twelvedata/price` | Real-time price | `symbol` |
| `/api/v1/twelvedata/quote` | Full quote | `symbol` |
| `/api/v1/twelvedata/eod` | End-of-day price | `symbol` |
| `/api/v1/twelvedata/exchange-rate` | Currency exchange rate | `symbol` (e.g., `USD/JPY`) |
| `/api/v1/twelvedata/forex-pairs` | Available forex pairs | — |
| `/api/v1/twelvedata/economic-calendar` | Economic events calendar | — |
| `/api/v1/twelvedata/metals/price` | Precious metals real-time | `symbol` (XAU/USD, XAG/USD) |
| `/api/v1/twelvedata/metals/time-series` | Metals OHLCV history | `symbol`, `interval` |
| `/api/v1/twelvedata/indices/list` | Global indices directory | — |
| `/api/v1/twelvedata/indices/quote` | Index quote | `symbol` (SPX, NDX, DJI) |
| `/api/v1/twelvedata/indicator/sma` | SMA | `symbol`, `interval`, `time_period`, `outputsize` |
| `/api/v1/twelvedata/indicator/ema` | EMA | `symbol`, `interval`, `time_period`, `outputsize` |
| `/api/v1/twelvedata/indicator/rsi` | RSI | `symbol`, `interval`, `time_period`, `outputsize` |
| `/api/v1/twelvedata/indicator/macd` | MACD | `symbol`, `interval` |
| `/api/v1/twelvedata/indicator/bbands` | Bollinger Bands | `symbol`, `interval`, `time_period` |
| `/api/v1/twelvedata/indicator/atr` | ATR (volatility) | `symbol`, `interval`, `time_period` |
| `/api/v1/twelvedata/time-series/complex` | Complex multi-indicator POST | JSON body |
**`interval` values:** `1min` `5min` `15min` `30min` `1h` `2h` `4h` `1day` `1week` `1month`
**Symbol examples:** `EUR/USD` `GBP/JPY` `BTC/USD` `AAPL` `XAU/USD` `SPX`
---
### 🤖 AI Inference — OpenAI, Anthropic, DeepSeek, Qwen — $0.001–$0.05/call
#### OpenAI (all POST except models)
| Endpoint | Description | Cost | Body |
|----------|-------------|------|------|
| `/api/v1/ai/openai/chat` | GPT-4o chat | $0.010 | `{model, messages, max_tokens}` |
| `/api/v1/ai/openai/chat/mini` | GPT-4o-mini chat | $0.001 | `{messages, max_tokens}` |
| `/api/v1/ai/openai/embeddings` | text-embedding-3-small | $0.001 | `{input, model}` |
| `/api/v1/ai/openai/embeddings/large` | text-embedding-3-large | $0.005 | `{input, model}` |
| `/api/v1/ai/openai/images` | DALL-E image generation | $0.050 | `{prompt, n, size}` |
| `/api/v1/ai/openai/models` | List available models (GET) | $0.001 | — |
#### Anthropic (all POST)
| Endpoint | Description | Cost | Body |
|----------|-------------|------|------|
| `/api/v1/ai/anthropic/messages` | Claude Sonnet (balanced) | $0.010 | `{model, max_tokens, messages}` |
| `/api/v1/ai/anthropic/messages/haiku` | Claude Haiku (fast, cheap) | $0.005 | `{max_tokens, messages}` |
| `/api/v1/ai/anthropic/messages/opus` | Claude Opus (best reasoning) | $0.015 | `{max_tokens, messages}` |
#### DeepSeek (POST except models)
| Endpoint | Description | Cost | Body |
|----------|-------------|------|------|
| `/api/v1/ai/deepseek/chat` | DeepSeek-Chat V3 (general tasks) | $0.003 | `{model, messages, max_tokens}` |
| `/api/v1/ai/deepseek/chat/reasoner` | DeepSeek-Reasoner (chain-of-thought) | $0.005 | `{messages, max_tokens}` |
| `/api/v1/ai/deepseek/completions` | FIM / non-chat completions (beta) | $0.003 | `{model, prompt, suffix, max_tokens}` |
| `/api/v1/ai/deepseek/models` | List available models (GET) | $0.001 | — |
**DeepSeek tip:** Use `chat/reasoner` for complex multi-step market analysis — it shows its reasoning chain.
#### Qwen / 通义千问 (all POST)
| Endpoint | Description | Cost | Body |
|----------|-------------|------|------|
| `/api/v1/ai/qwen/chat/max` | Qwen3-Max (flagship, most powerful) | $0.010 | `{messages, max_tokens}` |
| `/api/v1/ai/qwen/chat/plus` | Qwen-Plus (best value) | $0.005 | `{messages, max_tokens}` |
| `/api/v1/ai/qwen/chat/turbo` | Qwen-Turbo (fast response) | $0.002 | `{messages, max_tokens}` |
| `/api/v1/ai/qwen/chat/flash` | Qwen-Flash (ultra-low latency, cheapest) | $0.002 | `{messages, max_tokens}` |
| `/api/v1/ai/qwen/chat/coder` | Qwen3-Coder-Plus (code generation) | $0.005 | `{messages, max_tokens}` |
| `/api/v1/ai/qwen/chat/vl` | Qwen-VL-Plus (vision: image + text) | $0.005 | `{messages}` with image_url content |
**Qwen tip:** Use `chat/vl` to analyze candlestick chart screenshots or trading dashboards.
---
## Parameter Reference
### Crypto (Coinank / Nofxos)
| Parameter | Values / Format |
|-----------|-----------------|
| `exchange` | `Binance` `OKX` `Bybit` `Bitget` `dYdX` |
| `productType` | `SWAP` (perpetual futures) · `SPOT` |
| `interval` (crypto) | `1m` `5m` `15m` `1h` `4h` `1d` |
| `duration` (nofx) | `5m` `15m` `1h` `4h` `24h` |
| `endTime` | Unix timestamp in **milliseconds** — use `Date.now()` if omitted |
| `size` | Number of data points (default varies, max ~500) |
| `sortType` | `asc` or `desc` |
| `lang` (news) | `en` (English) · `zh` (Chinese) |
| RSI `interval` | **Uppercase**: `1H` `4H` `1D` |
### US Stocks
| Parameter | Values / Format |
|-----------|-----------------|
| `symbols` (Alpaca) | Comma-separated: `AAPL,TSLA,MSFT` |
| `timeframe` (Alpaca) | `1Min` `5Min` `15Min` `1Hour` `1Day` |
| `start` / `end` (Alpaca) | ISO date: `2024-01-01` |
| `timespan` (Polygon) | `minute` `hour` `day` `week` `month` `year` |
| `from` / `to` (Polygon) | ISO date: `2024-01-01` |
| `interval` (Alpha Vantage) | `1min` `5min` `15min` `30min` `60min` `daily` `weekly` `monthly` |
### China A-Shares
| Parameter | Values / Format |
|-----------|-----------------|
| `ts_code` | `000001.SZ` (Shenzhen) · `600000.SH` (Shanghai) |
| `start_date` / `end_date` | `YYYYMMDD`: `20240101` |
| `trade_date` | `YYYYMMDD`: `20240315` |
| `list_status` | `L` (listed) · `D` (delisted) · `P` (paused) |
---
## Tips for Best Results
- **Chain data calls** for richer analysis: fetch crypto signals → US stocks → run AI synthesis in one session
- **Use `Date.now()` for `endTime`** when fetching real-time crypto data
- **`exchanges=""` (empty string)** in Coinank market-order agg endpoints means all exchanges
- **POST endpoints** (AI, Twelvedata complex): use `node scripts/query.mjs <path> --post '<json>'`
- **VIP1/2/3/4 crypto endpoints** are accessible through claw402 like all others — no extra config
- **Free catalog**: `https://claw402.ai/api/v1/catalog` — always up to date, no payment required
- **Present results clearly**: use tables or bullet points, not raw JSON. Highlight the most actionable numbers
- **Cost check**: total for a full market analysis session (5–10 calls) is typically < $0.02 USDC
---
*Powered by [claw402.ai](https://claw402.ai) — x402 micropayment gateway for AI agents.*
don't have the plugin yet? install it then click "run inline in claude" again.