Skill: tinkle-community/claw402 (version 1.3.0)

--- 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?" | [REDACTED_SECRET] | | "Altcoin season?" | [REDACTED_SECRET] | | "Bitcoin cycle position?" | [REDACTED_SECRET], `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?" | [REDACTED_SECRET] | | "Bitcoin ETF inflows today?" | [REDACTED_SECRET] | | "Ethereum ETF flows?" | [REDACTED_SECRET] | | "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?" | [REDACTED_SECRET] | | "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?" | [REDACTED_SECRET] | | "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` · [REDACTED_SECRET] · `get_crypto_metrics` · `get_global_metrics_latest` · [REDACTED_SECRET] · `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 | — | | [REDACTED_SECRET] | Top net capital inflow coins | `limit`, `duration`, `type` | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | Upbit net inflow rankings | `limit`, `duration` | | [REDACTED_SECRET] | 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 | | [REDACTED_SECRET] | US BTC ETF historical net inflow | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | OI / market cap ratio history | `baseCoin`, `interval`, `size`, `endTime` | #### Liquidations | Endpoint | Description | Key Params | |----------|-------------|------------| | [REDACTED_SECRET] | Recent liquidation orders | `baseCoin`, `exchange`, `side`, `amount`, `endTime` | | [REDACTED_SECRET] | Liquidation stats by period | `baseCoin` | | [REDACTED_SECRET] | Aggregated liquidation history | `baseCoin`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Liquidation price-level clusters | `symbol`, `exchange`, `interval` | | [REDACTED_SECRET] | Liquidation heatmap | `exchange`, `symbol`, `interval` | #### Long/Short Ratios | Endpoint | Description | Key Params | |----------|-------------|------------| | [REDACTED_SECRET] | Real-time L/S ratio by exchange | `baseCoin`, `interval` | | [REDACTED_SECRET] | Global buy-sell L/S history | `baseCoin`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Account-level L/S ratio | `exchange`, `symbol`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Whale position-level L/S | `exchange`, `symbol`, `interval`, `size`, `endTime` | #### Funding Rates | Endpoint | Description | Key Params | |----------|-------------|------------| | [REDACTED_SECRET] | Real-time funding rate rankings | `type` (current/day/week/month/year) | | [REDACTED_SECRET] | Accumulated funding cost | `type` | | [REDACTED_SECRET] | Historical funding rates | `baseCoin`, `exchangeType`, `size`, `endTime` | | [REDACTED_SECRET] | Weighted average funding rate | `baseCoin`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Funding rate heatmap | `type` (openInterest/marketCap), `interval` | #### Whale Activity | Endpoint | Description | Key Params | |----------|-------------|------------| | [REDACTED_SECRET] | HyperLiquid whale positions | `sortBy`, `sortType`, `page`, `size` | | [REDACTED_SECRET] | 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 | |----------|-------------|------------| | [REDACTED_SECRET] | CVD for single pair | `exchange`, `symbol`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Aggregated CVD cross-exchange | `exchanges` (empty=all), `symbol`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | Taker buy/sell value USD | `exchange`, `symbol`, `interval`, `size`, `endTime` | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | 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 | |----------|-------------| | [REDACTED_SECRET] | Crypto fear & greed index | | [REDACTED_SECRET] | Altcoin Season Index | | [REDACTED_SECRET] | BTC 2-year MA multiplier | | [REDACTED_SECRET] | AHR999 accumulation indicator | | [REDACTED_SECRET] | Puell Multiple | | [REDACTED_SECRET] | 200-week MA heatmap | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | Dividends, splits, etc. | `symbols`, `types`, `start`, `end` | | `/api/v1/alpaca/options/bars` | Options OHLCV bars | `symbols`, `timeframe`, `start`, `end` | | [REDACTED_SECRET] | Options latest quotes | `symbols`, `feed` | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | Options contracts list | `underlying_asset`, `contract_type`, `expiration_date` | | [REDACTED_SECRET] | Single contract details | `options_ticker` | | [REDACTED_SECRET] | Options chain snapshot | `underlying_asset` | | [REDACTED_SECRET] | 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) | | [REDACTED_SECRET] | 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` | | [REDACTED_SECRET] | Currency exchange rate | `symbol` (e.g., `USD/JPY`) | | `/api/v1/twelvedata/forex-pairs` | Available forex pairs | — | | [REDACTED_SECRET] | Economic events calendar | — | | `/api/v1/twelvedata/metals/price` | Precious metals real-time | `symbol` (XAU/USD, XAG/USD) | | [REDACTED_SECRET] | Metals OHLCV history | `symbol`, `interval` | | `/api/v1/twelvedata/indices/list` | Global indices directory | — | | [REDACTED_SECRET] | Index quote | `symbol` (SPX, NDX, DJI) | | [REDACTED_SECRET] | SMA | `symbol`, `interval`, `time_period`, `outputsize` | | [REDACTED_SECRET] | EMA | `symbol`, `interval`, `time_period`, `outputsize` | | [REDACTED_SECRET] | RSI | `symbol`, `interval`, `time_period`, `outputsize` | | [REDACTED_SECRET] | MACD | `symbol`, `interval` | | [REDACTED_SECRET] | Bollinger Bands | `symbol`, `interval`, `time_period` | | [REDACTED_SECRET] | ATR (volatility) | `symbol`, `interval`, `time_period` | | [REDACTED_SECRET] | 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}` | | [REDACTED_SECRET] | 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}` | | [REDACTED_SECRET] | Claude Haiku (fast, cheap) | $0.005 | `{max_tokens, messages}` | | [REDACTED_SECRET] | 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}` | | [REDACTED_SECRET] | 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.*


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)