安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install skill-txf-roll
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 skill-txf-roll。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Blave Quant 是面向 AI 代理的市场数据与交易集成工具。它提供 Blave 加密货币 alpha 指标和原始市场数据、台湾股票和市场数据集、CME/ICE 与台湾期货 K 线，以及 Hyperliquid 交易者分析数据。开发者可以使用它研究市场、获取历史序列、筛选资产，并通过有文档说明的 API 端点构建数据驱动的工作流。
该技能还支持十家交易所的读取和交易工作流，包括 Binance、OKX、Bybit 和 Bitfinex。Openclaw Skills 用户可以使用广泛且一致的数据访问层以及针对各交易所的参考资料。交易操作受到强制安全流程保护：每项写入操作都需要预检查、清晰的操作摘要、用户准确回复 CONFIRM，以及操作后的验证。市场数据不构成财务建议。

应用场景

获取加密货币 alpha 指标，例如持有者集中度、主动买卖强度、巨鲸活动、挤压动量、市场方向和情绪。
比较跨交易所多空比、未平仓合约、CVD、清算数据和交易者敞口，用于研究或分析。
获取加密货币、台湾股票、台湾市场、台湾期货和 CME/ICE 的 OHLCV 数据，用于制图和回测。
使用最新的 alpha 表、已保存的筛选条件或台湾市值排名筛选资产。
使用报价、基本面、股息、机构资金流、保证金数据和券商分点买卖记录分析台湾股票。
跟踪 Hyperliquid 交易者的持仓、表现、历史记录和总体敞口。
读取交易所余额、持仓、报价和订单历史，或准备一项只有在明确确认后才会执行的交易操作。

工作原理

判断请求涉及市场数据、台湾股票研究、期货数据还是交易所活动。
在编写 API 调用前查阅相关参考文件。参考文件说明了参数、默认值、响应字段、错误以及针对各交易所的工作流。
检查所需凭证并使用相应 API。Blave 数据使用 Blave API 密钥和密钥；交易所交易使用对应交易所的凭证。
对于多币种排名或筛选，获取最新的 alpha_table；对于特定资产的历史序列，使用相应的单项端点。如果端点限制要求，则拆分较长的日期范围。
解析并呈现只读结果。报价、余额、持仓、订单历史、K 线和 alpha 数据均不需要确认。
执行任何写入操作前，预先检查适用的余额、持仓和限额，然后显示简明摘要，其中包括交易对、方向、数量、价格或触发条件、杠杆、预估成本，以及适用时的预估强平价格。
要求用户在当前对话中准确回复 CONFIRM。任何其他回复都会中止操作；一次确认仅授权一项操作。
执行已授权的操作，并通过相应的 GET 端点验证其状态。该技能会拒绝绕过确认或不经提示自主交易的请求。

配置指南

将 Blave 凭证添加到 OpenClaw 代理使用的环境中。Blave 市场数据需要 Blave 订阅和 API 密钥；技能文档列出了 14 天免费试用。
仅添加计划使用的交易所凭证。交易所密钥是可选的，且因服务商而异；如有要求，请提供密码短语或备注。
不要将密钥放入提示或源代码管理中。根据你的运维安全需求配置交易所 API 密钥的权限。
实现端点或交易所操作前，先阅读相关参考文件。

Blave 市场数据必需

blave_api_key=YOUR_BLAVE_API_KEY
blave_secret_key=YOUR_BLAVE_SECRET_KEY

可选交易所凭证示例（仅在需要时配置）

BINANCE_API_KEY=YOUR_BINANCE_API_KEY
BINANCE_SECRET_KEY=YOUR_BINANCE_SECRET_KEY
Blave API 基础 URL：https://api.blave.org。在 https://blave.org/landing/en/api?tab=blave 创建 Blave API 密钥；订阅详情请见 https://blave.org/landing/en/pricing。交易所设置请使用对应的 references/*-skill.md 文件。技能文档未指定任何特定的软件包安装命令。

数据架构

该技能是一个 API 访问层；文档未指定默认生成的本地数据文件。结果从服务商端点获取，并以各端点专属的响应格式返回。准确的参数、字段、日期覆盖范围和错误信息请参阅 references/blave-api.md。
数据组 代表性内容
加密货币 alpha 与市场数据 alpha 指标、筛选表、K 线、情绪、清算和板块轮动
跨交易所原始数据 多空比、未平仓合约、CVD、清算矩阵及相关历史序列
台湾股票与市场 报价、日线和日内 OHLCV、基本面、股息、机构资金流、券商数据和全台股价指数序列
期货与大宗商品 台湾 TXF 数据，以及 CME/ICE WTI（CL）、黄金（GC）和布伦特（BRN）K 线
Hyperliquid 分析 排行榜、交易者、持仓、成交、PnL、敞口历史和分组统计
交易所账户数据 各服务商专属的余额、持仓、订单和交易操作
响应通常包含时间序列或表格形式的市场记录。除非端点另有说明，时间戳均为 UTC。速率限制和历史数据上限因端点而异；Blave 通常允许每个 API 密钥和每个 IP 地址在五分钟内请求 500 次。部分台湾数据集在暂时不可用时可能返回 503；不得将此解读为没有交易。台湾券商数据的文档字段包括 date、broker_id、broker_name、stock_id、price、buy 和 sell。

高级特性

覆盖广泛的加密货币 alpha 数据，包括持有者集中度、巨鲸警报、挤压动量、市场方向、资金短缺、情绪和顶级交易者敞口。
提供多交易所原始数据集，用于分析多空比、未平仓合约、CVD 和清算，并支持历史未平仓合约数据以便回测。
台湾股票市场广度和基本面数据，包括调整后价格、机构活动、券商分点交易、财务报表、股息和市值排名。
覆盖台湾 TXF 和 CME/ICE 大宗商品合约的历史及日内期货数据。
提供 Hyperliquid 交易者跟踪功能，包括排行榜、持仓、表现、历史记录和总体分析。
集成 BitMart、OKX、Bybit、BingX、Bitget、Binance、Bitfinex、KuCoin 和 Gate.io，支持现货、衍生品及各服务商专属功能。
强制执行写入操作安全措施：每项下单、撤单、持仓变更、转账或资金操作都必须准确输入区分大小写的
CONFIRM
；确认不能停用，也不能重复用于其他操作。
提供数据使用指南，涵盖最新筛选请求、台湾股票全集的批量获取、日期范围限制、速率限制，以及临时服务错误的解读。

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 (every Binance USDT perpetual incl. tokenized stocks, 1min K線 from 2020-01 or listing), alpha table, 市場情緒 Market Sentiment, 每幣爆倉 Liquidation by coin (24 h USD liquidations per exchange + hourly series), 爆倉矩陣 liquidation exchange matrix (whole-market coin × exchange totals over a rolling window), 多空比 long/short ratio raw data (10 feeds — Binance / OKX / Gate.io × account, top account, top position + Bybit account; cross-coin table + per-coin 7-day hourly series), 未平倉量 open interest raw data (5 exchanges, USDT-margined perps in one-sided USD notional, OI ÷ market cap; table + per-coin) + 未平倉量歷史 open interest history (one coin on one exchange — Binance / Bybit / Gate.io — in coins, 5-minute resolution, for backtests), 主動買賣淨額 CVD (3 exchanges' taker buy/sell turnover, perps only; table + per-coin hourly cumulative), 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, with each row's listing board (TWSE 上市 / TPEx 上櫃) and ETF flag plus a 上市-ex-ETF market-cap denominator for weight calculations, and broker/dealer daily buy/sell by branch (台股日K/現股分線/向後調整/三大法人/融資融券/股權持股分級表/綜合損益表/資產負債表/現金流量表/股利事件/市值排名（含市場別、ETF 旗標與上市扣除ETF市值分母）/分點買賣超), 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 and intraday from 2011-01-03; (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/, /price/, /quote/, /per/) — 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/?date=) or by broker branch (broker/trader/?date=); by date or date range; via Blave API; no CAPTCHA required; (15) Gate.io trading — spot and USDT-settled perpetual futures, order placement, positions, leverage." version: 1.23.17