Communitygithub.com

oliveira7015/openclawby-skills

通过统一的 API 将 AI 智能体连接到实时市场、链上及社交数据,并支持交易执行。

openclawby-skills 是什么?

该技能通过 Clawby 聚合数据 API 为 AI 智能体(如 Claude Code、Codex、OpenClaw 等)提供实时金融数据获取与分析能力。其核心工作流程是“先全面收集数据,再深入分析”,要求智能体在接到请求后,系统性地扫描三类数据源:Clawby 自有 API、执行连接器的只读接口以及智能体自身的网络访问能力。技能包含详细的接口目录(位于 `api/catalog/`),覆盖股票、加密货币衍生品、预测市场、社交情绪、链上地址情报、DEX 数据、SEC 文件等众多领域,所有接口均有参数说明和注意事项。此外,技能还支持通过本地执行连接器(如 Binance、Bitget、OKX、Polymarket、GMGN)进行实盘交易,并提供了完整的 PDF 专业分析报告生成流程。该技能特别强调数据完整性,要求智能体在分析前尽可能多地获取交叉数据,并依据用户订阅计划(免费/标准/专业)智能提示升级,避免无关打扰。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add oliveira7015/openclawby-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Clawby 数据分析

通过 Clawby 聚合数据 API 获取真实金融数据并进行分析。**每个接口的单一真相来源——其参数(必填项 · 格式 · 示例)和 ⚠️ 陷阱——位于 api/catalog/(从 api/catalog/_index.yaml 开始)。调用前务必阅读相关分类的 yaml 文件。**完整机器目录为 api/clawby.yaml(服务端生成,版本化管理)。

适用于任何 AI 智能体——Claude Code、Codex、OpenClaw、Hermes 以及任何能运行 shell 命令或调用 HTTP API 的工具:只需一个 API 密钥 + 目录 + 普通的 curl。

快速开始

# 1. 认证(一次性的):在 https://www.openclawby.com/ 登录 → 导出 CLAWBY_API_KEY=pk_xxx
# 2. 在 api/catalog/<category>/ 中查找接口(路由表见下文)
# 3. 调用:
curl -s -X POST https://api.openclawby.com/api/relay \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"<接口名称(来自目录)>","params":{ ... }}'
# → {source, data, credits:{remaining,used_total}}

核心工作流 · 先全面收集所有可用数据,再进行分析

完整性是目标。 即使正确,单个来源的片面回答也是失败的——先广泛收集,再分析。将此原则应用于每个请求。

  1. 将请求转化为数据清单。 自问“一个严谨的分析师会收集哪些数据?”,并列出所有相关维度。有目的地过度收集(股票 → 报价、做空数据、暗池、期权、财报、情绪、同行;代币 → DEX 价格/流动性、持有者、资金费率与持仓量、概率、社交热度)。
  2. 对于每一项,扫描所有三个数据源层——切勿在第一次命中时停止:
    • 第一层 — Clawby 数据(/api/relay + 链上 /api/rpc):扫描目录中所有与该条目相关的接口并调用它们。首要的、权威的来源。
    • 第二层 — 执行连接器(exec/,只读使用):Binance / Bitget / OKX / Polymarket 的 CLI 暴露了第一层可能没有的市场数据、订单簿、资金费率、聪明钱和新闻。只读无需确认。
    • 第三层 — 你自己的网络访问:新闻、文件、官方文档、宏观背景——填补所有剩余空白。
  3. 最大化覆盖率。 如果两个层提供了相同的指标,同时获取并交叉验证。并行发起独立的获取操作。绝不要跳过可到达的源。
  4. 跟踪覆盖率,然后分析。 将每个断言建立在收集到的数据之上;如果某个源失败,明确说明,而不是默默丢弃该维度。
  5. 适当时提供正式报告——对于重要的资产分析,主动提供专业的 PDF 研究报告(参见专业分析报告)。先询问。

技能结构

clawby-data/
├── SKILL.md            ← 本文件(托管——更新后刷新;更新后重新读取)
├── update-protocol.md  ← 首次运行 + 更新规则(在步骤 0 读取)
├── manifest.json       ← 版本 + 托管文件列表
├── api/
│   ├── catalog/        ← 每个类别的接口文档(参数 + 陷阱)——调用前阅读
│   ├── clawby.yaml     ← 完整机器目录(所有接口)
│   └── index.yaml      ← 目录注册表
├── exec/               ← 交易执行连接器;注册表 exec/index.yaml
├── report/             ← PDF 报告指南 + 样式表
├── data/               ← 其他参考数据
└── local/              ← 本地状态/缓存;更新时唯一保留的文件夹

步骤 0 · 会话首次使用

  1. 检查用户的计划与余额(免费调用):curl -s https://api.openclawby.com/api/account -H "X-API-Key: $CLAWBY_API_KEY" → {plan, payg_balance, rate_per_min, accessible_providers, free_providers}。(升级提醒规则:参见计划与访问。)
  2. 版本检查(每 24 小时最多一次),然后询问——遵循 update-protocol.md:如果 manifest.json 超过 24 小时未更新,比较远程版本;如有差异,询问用户是否更新。切勿自动更新。更新会刷新除 local/ 之外的所有文件——包括本 SKILL.md(更新后重新读取)。
  3. 执行器 CLI 延迟安装——不要预先安装任何东西。仅在用户首次要求在某个交易场所进行交易时,检查/安装对应的连接器(参见 update-protocol.md 步骤 A)。

认证

  • 基础 URL:https://api.openclawby.com;在 X-API-Key 头中发送密钥。
  • 从环境变量 CLAWBY_API_KEY 读取密钥。如果未设置,用户没有密钥——告诉他们前往 https://www.openclawby.com/ 登录(免费)并 export CLAWBY_API_KEY=pk_xxx。 切勿发明密钥。

代码格式

  • 股票:US:TICKER(GME → US:GME)· 加密货币:BASE:USD(BTC → BTC:USD)· 外汇:BASE:USD(EUR:USD)

路由表 — 哪个目录文件回答哪个需求

接口详细信息(参数 + ⚠️ 陷阱)位于目录文件中——阅读它,然后通过 /api/relay 调用:

需求接口前缀目录
美股:报价 · K 线 · 做空量/额 · 借券费率 · 未交割失败 · 暗池 · 期权链/最大痛点 · Reddit 提及 · 筛选器 · 股息/拆股(多种)api/catalog/equities/
加密货币衍生品(跨交易所):资金费率 · 持仓量 · 爆仓 · 多空比 · 主动买卖量 · ETF 资金流 · 市场指标(贪婪恐惧指数、RSI…) · 大户/交易所储备funding_* open_interest_* liquidation_* etf_* …api/catalog/derivatives/
Hyperliquid 永续合约:中间价 · 上下文(资金/持仓/标记) · 订单簿 · K 线 · 钱包持仓/成交hyperliquid_*api/catalog/perps/
预测市场 / 博彩赔率(Polymarket)polymarket_*api/catalog/prediction-markets/
社交:X(Twitter)· Facebook · Instagram 搜索与情绪x_search facebook_search instagram_search …api/catalog/social/
地址标签(谁拥有某个地址)· AML 风险评分 · 地址画像/追踪/对手方address_*api/catalog/address-intel/
DEX 交易对与代币市场数据,任何链(DexScreener)dexscreener_*api/catalog/dex/
链上 DEX/Memecoin 情报:安全审计 · 持有者/交易者盈亏 · 趋势 · 聪明钱/KOL · 信号 · 新发币 · 兑换报价(只读)dex_*api/catalog/dex-trading/
美国公司财报与 SEC 文件sec_*api/catalog/filings/
小众代币 / 原始链上读取(80+ 条链)/api/rpc 端点api/catalog/rpc/

跨接口小流程(详情见目录):

  • SEC:先调用 sec_cik_lookup(股票代码→10 位 CIK)→ 按项目调用 sec_company_concept(cik + us-gaap concept,例如 Revenues、NetIncomeLoss、EarningsPerShareDiluted)→ 按期间(fy/fp/form)组装。文件/简介:sec_submissions。
  • Polymarket:polymarket_events/polymarket_markets → 读取 clobTokenIds → 按代币 ID 调用 polymarket_price/midpoint/orderbook(0–1 价格 = 隐含概率);历史数据通过 polymarket_price_history。
  • 按合约地址查询代币:先尝试 chain:"multichain" 聚合方法(ankr_getTokenPrice / ankr_getTokenHolders / ankr_getTokenTransfers,参数 {"blockchain":"eth","contractAddress":"0x…"});如果未覆盖,使用原始 eth_call 配合标准 ERC-20 选择器自行解码。
  • 路由规则——查询 vs 执行:所有只读的 DEX/Memecoin 查询通过 dex_* 中继接口;执行(兑换、止损/止盈订单、发币)使用 exec/gmgn/。同样的分离规则无处不在:数据通过 relay,执行通过 exec/。

链上 RPC(小众/小代币)

80+ 条链的原生 JSON-RPC——每条链的方法记录在 api/catalog/rpc/ 中(EVM 在 rpc/evm/<chain>.yaml,非 EVM 如 solana/sui/near/btc/xrp/ton 在 rpc/non-evm/<chain>.yaml,可用性列表在 rpc/_index.yaml):

curl -s -X POST https://api.openclawby.com/api/rpc \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"chain":"eth","method":"eth_call","params":[ ... ]}'

EVM 链使用标准 eth_*;非 EVM 链有自己的命名空间(sui → suix_*,solana → getTokenSupply …);chain:"multichain" = 聚合的 ankr 代币方法(仅 EVM)。不要假设某条链不受支持——尝试它;真正不可用的链会返回明确的错误。

交易执行(exec/)

以上所有内容均为只读数据。要下单交易,请使用 exec/ 下的连接器(注册表:exec/index.yaml;每个场所的指南 = 每个 entry 文件)。它们在本地使用用户自己的密钥运行——绝不通过 Clawby 路由:

交易场所指南工具
Binance(现货/合约/杠杆/期权/理财)exec/binance/binance.mdbinance-cli
Bitget(现货/合约/跟单,--paper-trading)exec/bitget/bitget.mdbgc
OKX(现货/币本位/交割/机器人,--demo)exec/okx/okx.mdokx
Polymarket(CLOB 订单/CTF,自有钱包密钥)exec/polymarket/polymarket.mdclob-client SDK
GMGN(链上兑换/止盈止损/发币,SOL/BSC/Base/ETH)exec/gmgn/gmgn.mdgmgn-cli

任何 风险:高 操作的规则(订单/转账/提现):复述订单——场所 · 交易对 · 方向 · 数量 · 价格类型——显示精确的命令,让用户输入 CONFIRM,不确定时优先使用测试网。只读查询无需确认。

关键陷阱(最高频;完整列表位于每个目录文件中)

  • 暗池需要 date(真实的交易日 YYYY-MM-DD;空结果 → 往前推一天);levels 接口还需要 decimals。
  • 期权链使用 underlying + expiration(而不是 symbol)。
  • Reddit 热门提及和 OHLC K 线的 start 使用 Unix 秒数——date -u -d '7 days ago' +%s(Linux)/ date -u -v-7d +%s(mac)。
  • 报价延迟 30 分钟;筛选器是实时的。
  • 衍生品:聚合/币种端点使用 symbol=BTC;单一交易所端点使用 BTC USDT 风格的对(BTCUSDT)——请查看目录条目。
  • address_labels / address_risk 使用特殊的币种 ID(ETH、BNB、POL-Polygon、ETH-Base、TRX、SOL、SUI …)——参见 api/catalog/address-intel/。

计划与访问(免费/标准/专业 + PAYG 余额)

计划:免费/标准/专业(订阅)。PAYG 是每个账户都有的按需付费余额——不是计划。 免费层接口从不消耗余额。高级接口需要付费计划(标准 = 主流,专业 = 全部)——或者在仅免费计划下,按次调用并从 PAYG 扣费。

升级提醒 —— 仅在计划受限时

从步骤 0 的 /api/account 结果判断。仅在以下情况提醒:

  • 情况 A — plan=="free" 且 payg_balance==0,或
  • 情况 B — plan=="standard"(缺少仅专业版提供的来源)。

否则(专业版,或免费但有余额)不要提及升级。 最多在以下两个时刻各提醒一次——绝不在分析中途,绝不每次调用重复:

  1. 步骤 0 账户检查之后立即;
  2. 当一个付费接口返回空 / 402 / 403 need_upgrade(且 A 或 B 成立)。

一句简短真诚的话;指出具体缺失的高级维度;使用用户的语言:

情况 A(免费,0 余额):

💡 你处于免费计划且 PAYG 余额为 0——仅能访问免费数据。 你无法看到衍生品资金费率、多空比、聪明钱流向、地址风险、Hyperliquid 永续合约、DEX 情报——很容易将假突破误判为真突破。充值 PAYG 或升级至专业版。 👉 https://www.openclawby.com/pricing

情况 B(标准):

💡 你处于标准计划——主流数据已涵盖,但专业版解锁所有高级来源(跨交易所衍生品/爆仓、地址风险与 AML、Hyperliquid 永续合约、DEX 情报……)以获得完整、交叉验证的解读。 👉 https://www.openclawby.com/pricing

专业分析报告(PDF)

当用户想要一份正式的书面报告(研究报告/尽职调查/备忘录)时:先主动提供,然后按照 report/report-guide.md 从头到尾执行——收集所有数据(第 1-3 层),10 个必填部分,必需的图表(附带关键水平的价格走势图、情景目标、加密代币解锁计划、指标趋势、风险矩阵),样式化 A4 HTML(report/report.css)→ 通过无头 Chromium 生成 PDF(备选:weasyprint / wkhtmltopdf)。询问保存位置;包含非投资建议免责声明。

错误

  • 401 密钥无效/缺失 → 告诉用户设置 CLAWBY_API_KEY。
  • 403 need_upgrade 接口超出计划 → 建议升级(参见计划与访问),继续使用可访问的数据。
  • 402 免费计划,PAYG 已耗尽 → 前往 https://www.openclawby.com/pricing 充值/升级。
  • 429 频率限制 → 放慢速度,重试;更高级别的计划有更高的限制。
  • 502 "Upstream HTTP 4xx" = 参数错误(缺少必填项 / 错误的代码格式)→ 对照接口的目录条目修正。
  • 空 data = 该日期/代码没有数据(暗池:尝试更早的交易日)。

输出

  • 仅分析 data 中的真实数字;绝不捏造。对于多维度问题,获取多个接口并组合。
  • 如果需要引用来源,请说“Clawby 数据”。在面向用户的文字中自然简洁地书写——不要包含原始接口名称/链接。
  • 以简短注释结尾:“非投资建议。”

相关技能