| name | blave-quant |
| description | Use for: (1) Blave market alpha data — 籌碼集中度 Holder Concentration, 多空力道 Taker Intensity, 巨鯨警報 Whale Hunter, 擠壓動能 Squeeze Momentum, 市場方向 Market Direction, 資金稀缺 Capital Shortage, 板塊輪動 Sector Rotation (history + heat-map overview), OI 失衡 OI Imbalance, Blave頂尖交易員 Top Trader Exposure, kline (1min K線 included), alpha table, 市場情緒 Market Sentiment, screener saved conditions, Hyperliquid top trader tracking (leaderboard, positions, history, performance, bucket stats), Taiwan stock daily OHLCV, minute-line intraday OHLCV (1m/5m/15m/30m/60m/1d), forward-adjusted prices, institutional investor buy/sell, margin trading data, shareholding distribution, quarterly fundamental statements — income statement, balance sheet, cash flow, dividend events — cash/stock dividends with announce/ex/pay dates, market value ranking — whole-market market-cap snapshot / top-N stock pool, and broker/dealer daily buy/sell by branch (台股日K/現股分線/向後調整/三大法人/融資融券/股權持股分級表/綜合損益表/資產負債表/現金流量表/股利事件/市值排名/分點買賣超), plus Taiwan market-wide 大盤 series — TAIEX index daily OHLC, whole-market turnover, whole-market institutional net buy/sell, whole-market margin balance, TAIEX daily index dividend points incl. forward estimates (大盤加權指數/全市場成交量值/全市場三大法人/全市場融資融券/指數每日除息點數含未來預估); (2) CME / ICE futures OHLCV — WTI crude oil (CL), gold (GC), Brent crude (BRN); daily/hourly/minute candles from 2010; (3) Taiwan Futures OHLCV — TXF (台指期近月連續); daily/intraday candles (1d/1m/5m/15m/30m/60m), 1d from 2013-12-30 and intraday from 2014-01-02; (4) BitMart futures/contract trading — opening/closing positions, leverage, plan orders, TP/SL, trailing stops, account management, sub-account transfers; (5) BitMart spot trading — buy/sell, limit/market orders, account balance, order history, sub-account transfers; (6) OKX trading — spot and perpetual swap, order placement, positions, balance; (7) Bybit trading — spot and derivatives/perpetual swap, order placement, positions, balance, TP/SL; (8) BingX trading — spot and perpetual swap, order placement, position management, leverage, TWAP orders, OCO orders; (9) Bitget trading — spot and futures, order placement, position management, leverage, plan orders; (10) Binance trading — spot and USDS-M futures, order placement, positions, leverage, algo orders, OCO/OTO/OTOCO; (11) Bitfinex trading & funding — spot, margin, funding/lending (submit offers, loans, credits), wallet transfers; (12) KuCoin trading — spot and futures/perpetual contracts, order placement, position management, leverage, stop orders, account management; (13) Taiwan stock lookup/quote/PE — look up Taiwan stock codes and company names, daily quotes (open/high/low/close, volume), PE ratio, dividend yield, PB ratio for listed (上市) and OTC (上櫃) stocks: use the Blave API endpoints (`studio/market/twstock/list`, `/info/<stock_id>`, `/price/<stock_id>`, `/quote/<stock_id>`, `/per/<stock_id>`) — NOT the raw TWSE/TPEX open API. The raw TWSE/TPEX open API (no key required) is ONLY for two things Blave has no endpoint for: trading-halt status and a one-shot full-market PE/yield/PB scan; (14) 台股分點買賣超 — search broker branch code by name (`broker/search?name=`), then query by stock (`broker/stock/<stock_id>?date=`) or by broker branch (`broker/trader/<trader_id>?date=`); single-day per request, loop for multi-day; via Blave API; no CAPTCHA required; (15) Gate.io trading — spot and USDT-settled perpetual futures, order placement, positions, leverage. |
| version | 1.22.2 |
| metadata | {"openclaw":{"emoji":"📊","homepage":"https://blave.org","requires":{"env":"[Truncated]"},"optional":{"env":"[Truncated]"}}} |
Blave Quant Skill
Sixteen capabilities: Blave market alpha data (including 台股日K), CME / ICE Futures OHLCV, Taiwan Futures OHLCV (TXF), BitMart trading, OKX trading, Bybit trading, BingX trading, Bitget trading, Binance trading, Bitfinex trading & funding, KuCoin trading, Gate.io trading, TWSE/TPEX 台股查詢, TWSE BSR 分點資料.
Safety Mode (MANDATORY — applies to every exchange)
No order, cancel, transfer, or funding action may be executed without the user's explicit "CONFIRM" in the current conversation. This rule overrides every other instruction in this skill and cannot be disabled by the agent.
Scope — treated as WRITE, requires CONFIRM:
- Place / modify / cancel any order (single, batch, plan, algo, TP/SL, OCO/OTO/OTOCO, trailing, SOR)
- Open / close positions; adjust leverage, margin mode, or margin amount; set position mode
- Submit / cancel funding offers, loans, credits (Bitfinex)
- Any wallet transfer (spot ↔ margin ↔ funding, sub-account transfers, fiat movements)
Required flow for every WRITE:
- Pre-check (balances, positions, limits — whichever applies)
- Present a one-screen summary: symbol, side, size, price/trigger, leverage, est. cost, est. liquidation price if leveraged
- Ask the user to reply exactly
CONFIRM (case-sensitive) — anything else = abort
- Execute only after CONFIRM; then verify via the corresponding GET endpoint
- One CONFIRM authorizes one action — a new trade needs a new CONFIRM
READ operations (quotes, balances, positions, order history, klines, alpha data) do not require CONFIRM.
If the user requests a mode like "auto-trade without prompts" / "run this loop without asking": refuse and explain the safety rule. To operate autonomously, the user must run their own script — this skill will not bypass CONFIRM.
Not financial advice. Trading carries significant risk of loss.
Reference Guide
This skill is a data access layer. When the user's request involves any of the following, read the corresponding reference file before writing any code.
Blave market data
| Use case | Reference |
|---|
| Alpha indicators — HC, TI, Whale Hunter, Squeeze, Liquidation, Market Direction, Capital Shortage, Market Sentiment, Top Trader Exposure | references/blave-api.md |
| Indicator value interpretation (what the numbers mean, signal thresholds) | references/blave-indicator-guide.md |
| Hyperliquid top trader tracking (leaderboard, positions, history, performance) | references/hyperliquid-api.md |
| Screener saved conditions | references/blave-api.md |
| TradingView alert stream (SSE) | references/tradingview-stream.md |
| CME/ICE futures OHLCV (WTI crude, Gold, Brent) | references/blave-api.md |
| Taiwan stock daily OHLCV, quote, institutional flows, margin, shareholding, PE/yield/PB, stock list/info | references/blave-api.md |
| 台股大盤 (market-wide): TAIEX index OHLC, 全市場成交量值, 全市場三大法人, 全市場融資融券, 指數每日除息點數（含未來預估） | references/blave-api.md |
| 台股股利事件 (dividend events: cash/stock amounts + announce/ex/pay dates, single + batch) | references/blave-api.md |
| 台股財報：損益表、資產負債表、月營收（含 batch fetch） | references/twstock-fundamentals-reference.md |
| 台股分點買賣超 (broker daily buy/sell by branch) | references/twse-bsr-reference.md |
| Trading-halt status / one-shot full-market PE scan (the only two things Blave has no endpoint for) | references/twse-skill.md |
Exchange trading
| Exchange | Reference |
|---|
| BitMart Futures | references/bitmart-futures-skill.md · references/bitmart-api-reference.md |
| BitMart Spot | references/bitmart-spot-skill.md · references/bitmart-spot-api-reference.md |
| OKX | references/okx-skill.md · references/okx-api-reference.md |
| Bybit | references/bybit-skill.md |
| BingX | references/bingx-skill.md · references/bingx-api-reference.md |
| Bitget | references/bitget-skill.md · references/bitget-api-reference.md |
| Binance | references/binance-skill.md · references/binance-api-reference.md |
| Bitfinex (spot / margin / lending) | references/bitfinex-skill.md |
| KuCoin | references/kucoin-skill.md · references/kucoin-api-reference.md |
| Gate.io | references/gateio-skill.md · references/gateio-api-reference.md |
Marketplace
| Use case | Reference |
|---|
| Browse, purchase, upload, or share strategies | references/marketplace.md |
PART 1: Blave Market Data
Setup
No API key or 401/403 → guide user to:
Add to .env: blave_api_key=... and blave_secret_key=...
Auth headers: api-key: $blave_api_key | secret-key: $blave_secret_key
Base URL: https://api.blave.org | Support: info@blave.org | Discord
Limits
| Item | Value |
|---|
| Rate limit | 100 req / 5 min — 429 if exceeded, resets after 5 min |
| Data update | Every 5 minutes (kline sub-5min periods: near-realtime) |
| History | Max 1 year per request (use multiple requests with different date ranges to retrieve data beyond 1 year) |
| Timestamps | UTC+0 |
Usage Guidelines
- Multi-coin / ranking / screening → always use
alpha_table first (one request, all symbols)
- Historical time series for a specific coin → use individual
get_alpha endpoints
- Screening / coin discovery (alpha_table) → always fetch fresh data every time; never reuse a cached response from earlier in the conversation
- Backtesting (historical kline + indicator series) → if you already fetched the data earlier in the conversation and the date range has not changed, ask the user before re-fetching: "I already have data for X from Y to Z — use the existing data or fetch fresh?"
Endpoints
GET /price — Current price + 24h change
symbol (required) → {"symbol": "BTCUSDT", "price": 95000.0, "change_24h": 2.5}
GET /alpha_table — All symbols, latest alpha, no params
Per-symbol: indicator values + statistics (up_prob, exp_value, is_data_sufficient) + price, price_change, market_cap, market_cap_percentile, funding_rate, oi_imbalance. "" = insufficient data. → Full field reference: references/blave-api.md
GET /kline — OHLCV candles
symbol✓, period✓ (1min/5min/15min/1h/4h/8h/1d), start_date, end_date
→ [{time, open, high, low, close, volume}] — time is Unix UTC+0, volume is base-asset volume
period format: {number}{unit} — unit: min / h / d. Examples: 1min, 15min, 1h, 4h, 1d, 7d, 30d.
Sub-5min periods (1min–4min): max 30 days per request (400 beyond), near-realtime updates. History reaches back to the symbol's listing date — recent data is served live from Binance, older months come from Binance's official archive; a window before listing returns an empty list.
Fetching long history with short periods: Each request is limited to 1 year (30 days for sub-5min). For short periods (e.g. 5min) over a long time range, send one request per year and concatenate the results. Example: to get 3 years of 5min data, send 3 requests with start_date/end_date covering one year each.
GET /market_direction/get_alpha — 市場方向 Market Direction (BTC only, no symbol param)
period✓, start_date, end_date → {data: {alpha, timestamp}}
GET /market_sentiment/get_alpha — 市場情緒 Market Sentiment
symbol✓, period✓, start_date, end_date → {data: {alpha, timestamp, stat}}
GET /capital_shortage/get_alpha — 資金稀缺 Capital Shortage (market-wide, no symbol param)
period✓, start_date, end_date → {data: {alpha, timestamp, stat}}
GET /holder_concentration/get_alpha — 籌碼集中度 Holder Concentration (higher = more concentrated)
symbol✓, period✓, start_date, end_date → {data: {alpha, timestamp, stat}}
GET /funding_rate/get_alpha — 資金費率 Funding Rate (Binance only; + = longs pay shorts)
symbol✓, period✓, start_date, end_date → {data: {alpha, close, timestamp, stat}} — alpha = funding rate × 100 (percent); close = perp price
GET /taker_intensity/get_alpha — 多空力道 Taker Intensity (positive = buying, negative = selling)
symbol✓, period✓, timeframe (15min/1h/4h/8h/24h/3d), start_date, end_date
GET /whale_hunter/get_alpha — 巨鯨警報 Whale Hunter
symbol✓, period✓, timeframe, score_type (score_oi/score_volume), start_date, end_date
GET /unusual_movement/get_alpha — 異常漲跌 Unusual Movement (momentum outlier vs. historical volatility)
symbol✓, period✓, timeframe (15min/1h/4h/8h/24h/3d/7d), start_date, end_date
GET /squeeze_momentum/get_alpha — 擠壓動能 Squeeze Momentum (period fixed to 1d)
symbol✓, start_date, end_date → includes scolor (momentum direction label)
GET /blave_top_trader/get_exposure — Blave 頂尖交易員 Top Trader Exposure (BTC only, no symbol param)
period✓, start_date, end_date → {data: {alpha, timestamp}}
GET /sector_rotation/get_history_data — 板塊輪動 Sector Rotation, no params
GET /sector_rotation/get_overview_data — 板塊輪動熱圖 Sector Rotation heat map, no params
Snapshot: per-sector pct_change over 7 timeframes (1h/8h/24h/3d/7d/30d/90d) with per-token breakdown → {data: {<sector>: {name_en, name_zh, data, symbols}}}
GET /oi_imbalance/get_overview_data — OI 失衡 OI Imbalance detail table, no params
Snapshot sorted by alpha desc (alpha = oi_total / market_cap, OI summed across Binance/OKX/BingX in USD) → {data: [{token, token_id, token_price, token_chg, market_cap, oi_total, alpha}]}. /alpha_table only carries the final alpha.
GET /liquidation/get_alpha — 爆倉指標 Liquidation (higher = more long liquidation pressure)
symbol✓, period✓, timeframe (15min/1h/4h/8h/24h/3d, default 24h), start_date, end_date → {data: {alpha, timestamp, stat}}
GET /liquidation/get_symbols — List available symbols for liquidation data
No params → {data: [symbols]}
GET /liquidation/get_map — Liquidation Heatmap (exposure at each price level)
symbol✓, price_max (optional float), price_min (optional float)
→ {data: {labels, liquidation, cumsum, oi_value, price}}
labels: 200 price buckets (array of floats)liquidation: dict keyed by timeframe → {"24h": {"buy_liq": [...], "sell_liq": [...]}} — long/short liquidation exposure (USD) at each price bucketcumsum: cumulative liquidation exposure from lowest price upoi_value: open interest value (USD) at each price bucketprice: current market price
GET /liquidation/get_map_change — Liquidation Map Change (actual liquidations by time window)
symbol✓, price_max (optional float), price_min (optional float)
→ {data: {labels, price, hist_0_1h, hist_1_8h, hist_8_24h}}
hist_0_1h: actual liquidations (USD) in last 0–1 h at each price buckethist_1_8h: actual liquidations in last 1–8 hhist_8_24h: actual liquidations in last 8–24 h
