Unusual Whales API

安装指南

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

什么是

Unusual Whales API 技能可帮助 AI 代理通过已记录的端点获取期权和市场数据，包括单笔期权交易、资金流提醒、暗池成交记录、Market Tide、希腊值、伽马敞口、财务报表和技术指标。它会将常见的金融问题映射到相应的 API 路由，让用户无需猜测端点名称即可探索数据。
它的核心价值在于规范且更安全地使用 API：请求使用官方 API 主机、Bearer 令牌身份验证、必需的客户端标头以及严格的端点白名单。对于使用 Openclaw Skills 构建应用的开发者，它提供了一个实用的 Unusual Whales 数据接口，同时明确防范常见的幻觉路由和不安全的 API 密钥查询参数。

应用场景

查找异常期权活动、鲸鱼交易、资金流提醒或单笔期权逐笔成交记录。
使用权利金、成交量、类型和价外状态等筛选条件筛查期权合约和期权链。
查看特定股票代码或整个市场的暗池活动。
查看 Market Tide、净权利金、期权成交量或与看跌/看涨相关的情绪数据。
按行权价获取合约希腊值、隐含波动率和伽马敞口。
查询内部人士或政客的交易记录以及财经新闻标题。
获取公司财务数据、损益表、资产负债表、现金流量表和历史财报数据。
请求 RSI、MACD、BBANDS、STOCH、VWAP 或移动平均线等技术指标序列。

工作原理

理解用户请求，并将其术语（例如“鲸鱼提醒”“暗池”或“GEX”）映射到已记录的端点。
仅从技能的有效端点参考中选择路由；不要虚构路由，也不要使用列出的幻觉黑名单路径。
从 UW_API_KEY 环境变量读取 API 令牌，并将其作为 Bearer 令牌放入 Authorization 标头中。请求中还需包含 UW-CLIENT-API-ID: 100001。
向 https://api.unusualwhales.com 发出 GET 请求，并将受支持的筛选条件作为查询参数传入。对于列表参数，在适用时使用重复的方括号表示法。
返回与问题相关的响应数据，保留 API 报告的字段，不要捏造缺失的详细信息。

配置指南

从 API 控制面板创建 Unusual Whales API 令牌。使用 API 需要付费 API 方案或试用资格。
将令牌设置为环境变量；切勿将其放入 URL 或提交到源代码管理系统。
export UW_API_KEY="your_api_token"
配置代理或运行环境以加载此技能，并且仅向 https://api.unusualwhales.com 发送出站请求。
使用 Authorization: Bearer $UW_API_KEY 和 UW-CLIENT-API-ID: 100001 发送请求。仅使用 GET 方法，并从已记录的白名单中选择端点。
也可以使用官方 MCP 服务器并提供相同的令牌。托管端点为 https://api.unusualwhales.com/api/mcp；本地选项为设置好 UW_API_KEY 后运行 npx -y @unusualwhales/mcp。设置指南请参阅 https://unusualwhales.com/public-api/mcp。

数据架构

此技能不定义本地存储格式，也不会生成文件；它会向 Unusual Whales API 请求数据，并处理返回的 JSON 响应，通常从 data 字段读取记录。
数据类别 已记录的端点示例 响应字段示例
期权交易和资金流提醒 /api/option-trades、/api/option-trades/flow-alerts option_chain_id、executed_at、price、size、premium、total_premium
期权筛选器 /api/screener/option-contracts ticker_symbol、option_symbol、ask_side_volume、avg_price
暗池 /api/darkpool/recent、/api/darkpool/{ticker} ticker、price、size、executed_at
市场情绪 /api/market/market-tide timestamp、net_call_premium、net_put_premium
希腊值和敞口 /api/stock/{ticker}/greeks、/api/stock/{ticker}/spot-exposures/strike 行权价层级的希腊值和敞口字段，包括 put_gamma_oi
基本面和技术指标 /api/stock/{ticker}/financials 以及报表、财报或技术指标路由 API 响应字段取决于所选端点和参数
身份验证信息通过 UW_API_KEY 环境变量提供。请求使用官方 API 主机名、Bearer 授权标头以及必需的 UW-CLIENT-API-ID 客户端标头。受支持的筛选条件和参数名称因端点而异，详见技能的端点参考。

高级特性

防止幻觉的保护措施：强制使用官方基础 URL、仅限
GET
方法、必需的标头以及严格的端点白名单。
端点意图映射：将常见金融术语转换为已记录的 API 路由。
精细的期权交易筛选条件：在受支持的情况下，包括权利金、规模、成交量、未平仓合约数、DTE、标签、行业和交易代码。
重复方括号表示法支持
tags[]
issue_types[]
等列表查询参数。
期权交易端点通过已记录的
include_agg_trades
选项提供聚合交易支持。
支持使用相同 API 令牌的 MCP 替代方案，包括托管版和本地版。
提供相关技能链接，涵盖 API 使用情况监控、机构数据、WebSocket 访问、财报波动率扫描、期权数据湖和 MCP 仪表板。

name: unusual-whales-api description: Query the Unusual Whales API for unusual options flow, dark pool prints, market tide, stock greek exposure, financial statements, and technical indicators. version: 1.0.0