kraken-cli-chainvector

# Kraken CLI × ChainVector   Kraken CLI 是 Kraken 交易所的命令行接口，支持使用 ChainVector 作为内置的信号智能层。Kraken 执行交易，ChainVector 提供决策依据。 提供完整的 Kraken API 访问权限，以及 ChainVector 的市场趋势检测、动量、概率引擎、鲸鱼流量、清算、资金和策略顾问。内置 MCP 服务器，支持实时和模拟交易。单个二进制文件即可使用。 支持 Cursor、Claude、Codex、Copilot、Gemini、Goose 和 OpenClaw 等 AI 代理。 尝试使用以下命令与您的 AI 代理交互： > *"当前 BTC 市场趋势如何？在接下来的 15 分钟内，我应该做多、做空还是保持中立？*" > *"运行 `kraken strategy advise` 命令，如果没有否决，立即在期货模拟交易中按照建议的止损和目标价位进行交易。*" > *"BTC 在接下来的 1 小时内触及 100k 的概率是多少？在该价格区间内有哪些清算集群？*" > *"扫描各交易所的资金流向，为我找到一个 delta-neutral 的 carry 交易对。*" > *"您是一位拥有 20 年经验的华尔街资深人士，使用 ChainVector 信号进行 BTC 模拟交易 15 分钟，并展示您的盈亏情况。*" --- > [!CAUTION] > 该软件为实验性软件，与 Kraken 实时交易所交互，可执行实际金融交易。在使用真实资金或 AI 代理之前，请阅读 [DISCLAIMER.md](DISCLAIMER.md)。 ## 目录 - [安装](#installation) - [ChainVector 智能](#chainvector-智能) - [可交易资产](#what-you-can-trade) - [快速入门](#quick-start) - [MCP 服务器](#mcp-服务器) - [模拟交易](#paper-trading) - [命令](#commands) - [API 密钥和配置](#api-keys--configuration) - [贡献](#contributing) - [许可证和免责声明](#license--disclaimer) ## 安装 单个二进制文件，无运行时依赖。需要 [Rust](https://rustup.rs/) 进行编译。 ```bash cargo install --git https://github.com/C0inFlips/kraken-cli-chainvector ``` 或克隆并编译： ```bash git clone https://github.com/C0inFlips/kraken-cli-chainvector.git cd kraken-cli-chainvector cargo install --path . ``` 二进制文件仍命名为 `kraken`。验证其是否正常工作： ```bash kraken status && kraken ticker BTCUSD kraken signals status # 需要 CHAINVECTOR_API_KEY ``` ## ChainVector 智能 两组命令将 ChainVector 的 API 转化为每笔交易的决策层。两组命令均为只读，需要 ChainVector API 密钥，无需 Kraken 凭证。 ```bash export CHAINVECTOR_API_KEY="cv_live_..." # 在 https://chainvector.com 获取 ``` ### `kraken signals` — 原始智能（32 个命令） ```bash kraken signals snapshot --symbol BTC -o json # 一次性机器人决策快照 kraken signals regime --symbol BTC -o json # 趋势/震荡/平静/挤压设置/瀑布式 kraken signals momentum --symbol BTC -o json # 跨交易所动量，-100..+100 kraken signals probability --symbol BTC-USDT --target 100000 --horizon 15m -o json kraken signals whale-pressure --symbol BTC -o json # 鲸鱼净流量 kraken signals cascade-risk --symbol BTC -o json # 清算级联概率 kraken signals heatmap --symbol BTC -o json # 清算集群水平 kraken signals funding-squeeze --symbol BTC -o json # 多头挤压得分 kraken signals risk-index -o json # 0-100 市场压力综合指数 kraken signals screener -o json # 排名所有跟踪资产 ``` 还包括：`lead-lag`、`volatility`、`indicators`、`whale-trades`、`liquidations`、`funding`、`funding-weighted`、`funding-arbitrage`、`basis`、`positioning`、`long-short`、`cvd`、`book-imbalance`、`book-walls`、`open-interest`、`history`、`options-probability`、`prediction-markets`、`prediction-quotes`、`prediction-stability`、`prediction-edge`、`status`。 ### `kraken strategy` — 综合顾问（6 个命令） 每个顾问将多个信号融合成一个结构化决策：行动（`long`/`short`/`flat`）、置信度、否决列表、规模乘数和波动性缩放止损/目标。顾问永远不会下订单 — 执行始终与 Kraken 命令组保持一致。 ```bash kraken strategy advise --symbol BTC --horizon-min 15 -o json # 完整集成：趋势门控 + 预期价值 + 否决 kraken strategy momentum --symbol BTC -o json # 动量持续性检查 kraken strategy meanrev --symbol BTC -o json # 均值回归检查 kraken strategy squeeze --symbol BTC -o json # 资金挤压玩法 kraken strategy cascade-fade --symbol BTC -o json # 渐进式清算 kraken strategy carry -o json # delta-neutral 资金携带扫描 ``` ### 循环 ```bash ACTION=$(kraken strategy advise --symbol BTC -o json 2>/dev/null | jq -r '.action') case "$ACTION" in long) kraken paper buy BTCUSD 0.01 -o json ;; short) kraken futures paper sell PF_XBTUSD 1 --leverage 5 --type market -o json ;; flat) echo "no trade" ;; esac ``` 查看 [skills/recipe-signal-driven-trade](skills/recipe-signal-driven-trade/SKILL.md) 以获取完整的带有否决门控和风险指数电路中断的工作流程。 ## 可交易资产 一个二进制文件涵盖六种资产类别。所有交易命令都跨资产类别工作，使用相同的接口；按需传递 `--asset-class` 参数。 | 资产类别 | 工具 | 保证金 | 标志 | 示例 | |---|---|---|---|---| | **加密货币现货** | 1,400+ 交易对（BTC、ETH、SOL 等数百种） | 主要交易对最高 10 倍杠杆 | _(默认)_ | `kraken order buy BTCUSD 0.001 --type limit --price 50000` | | **代币化美国股票和 ETF ([xStocks](https://www.kraken.com/xstocks))** | 79 种资产：AAPL、NVDA、TSLA、GOOGL、AMZN、MSFT、SPY、QQQ 等 | 前 10 名最高 3 倍杠杆 | `--asset-class tokenized_asset` | `kraken order buy AAPLx/USD 0.1 --type limit --price 200 --asset-class tokenized_asset` | | **外汇** | 11 种法定货币对：EUR/USD、GBP/USD、USD/JPY、AUD/USD 等 | - | `--asset-class forex` | `kraken ticker EURUSD --asset-class forex` | | **永续期货** | 317 种合约：加密货币、5 种外汇永续合约、11 种股票/指数永续合约（AAPL、NVDA、TSLA、SPY、QQQ、S&P 500） | 最高 50 倍杠杆 | _(期货引擎)_ | `kraken futures order buy PF_XBTUSD 1 --type limit --price 50000` | | **逆向和固定日期期货** | 20 种合约：BTC、ETH、SOL、LTC、XRP、ADA、DOGE、LINK | 各不相同 | _(期货引擎)_ | `kraken futures order buy FI_XBTUSD_260327 1 --type limit --price 50000` | | **赚取 / 质押** | 跨多个资产的灵活和绑定策略 | - | - | `kraken earn strategies --asset ETH` | *xStocks 在美国不可用。所有产品的可用性因管辖权而异。* ## 面向 AI 代理 如果您是 AI 代理或正在构建一个，请从这里开始： | 资源 | 描述 | |----------|-------------| | [CONTEXT.md](CONTEXT.md) | 工具使用代理的运行时上下文 | | [AGENTS.md](AGENTS.md) | 完整集成指南：身份验证、调用、错误、速率限制 | | [agents/tool-catalog.json](agents/tool-catalog.json) | 189 个命令的参数模式、类型和安全标志 | | [agents/error-catalog.json](agents/error-catalog.json) | 9 个错误类别，带有重试指南 | | [skills/](skills/) | 53 个目标导向的 SKILL.md 工作流程包 | | [CLAUDE.md](CLAUDE.md) | Claude 特定集成指南 | 核心调用模式： ```bash kraken <command> [args...] -o json 2>/dev/null ``` - 成功时，stdout 始终为有效 JSON，失败时为 JSON 错误信封。 - 退出代码 0 表示成功，非零表示失败。 - stderr 仅携带诊断信息（启用 `-v` 时）。永远不要解析 stderr 中的数据。 <details> <summary>为什么选择 Agent-First？</summary> 大多数 CLI 都为终端用户设计。而本 CLI 为 LLM 代理、MCP 工具服务器和需要可靠调用 Kraken 的自动化管道而构建。 - **默认结构化输出。** 每个命令都支持 `-o json`。无需屏幕抓取，无需正则表达式。 - **一致的错误信封。** 错误为 JSON 对象，具有稳定的 `error` 字段（`auth`、`rate_limit`、`validation`、`api`、`network`）。代理根据 `error` 进行路由，无需解析人类句子。 - **可预测的退出代码。** 成功为 0，失败为非零。与 JSON 错误结合使用，代理可编程检测和分类失败。 - **模拟交易用于安全迭代。** 使用 `kraken paper`（现货）和 `kraken futures paper`（永续期货）命令测试策略，无需 API 密钥，无需真实资金，接口与实时交易相同。 - **完整的 API 接口。** 189 个命令涵盖现货、期货、xStocks、外汇、资金、赚取、子账户、WebSocket 流媒体、模拟交易（现货和期货）和 ChainVector 信号智能。 - **内置 MCP 服务器。** 原生 Model Context Protocol 支持通过 stdio。无需子进程包装器。 - **速率限制感知。** 无客户端限制。当 Kraken API 因速率限制拒绝请求时，CLI 返回一个丰富的错误，包含 `suggestion`、`retryable` 和 `docs_url` 字段，以便代理可以阅读文档并调整策略。 人类受益于相同的设计：`--output table` 渲染干净的表格，`kraken shell` 提供 REPL，`kraken setup` 引导配置。 </details> ## 快速入门 公共市场数据无需凭证： ```bash kraken ticker BTCUSD -o json kraken orderbook BTCUSD --count 10 -o json kraken trades BTCUSD --count 20 -o json kraken ohlc BTCUSD --interval 60 -o json ``` ChainVector 智能仅需 ChainVector 密钥： ```bash export CHAINVECTOR_API_KEY="cv_live_..." kraken signals snapshot --symbol BTC -o json kraken strategy advise --symbol BTC -o json ``` 使用身份验证： ```bash export KRAKEN_API_KEY="your-key" export KRAKEN_API_SECRET="your-secret" kraken balance -o json kraken open-orders -o json kraken order buy BTCUSD 0.001 --type limit --price 50000 -o json ``` 适用于人类（表格输出，交互式设置）： ```bash kraken setup kraken ticker BTCUSD kraken balance kraken shell ``` ## API 密钥和配置 身份验证命令（交易、余额、订单管理）需要一对 Kraken API 密钥。公共市场数据和模拟交易无需凭证。 ### 获取 API 密钥 **现货**（涵盖交易、余额、资金、赚取、子账户）：[Settings > API](https://www.kraken.com) 在 kraken.com 上。完整指南： [如何创建现货 API 密钥](https://support.kraken.com/articles/360000919966-how-to-create-an-api-key). **期货**（仅限 `kraken futures` 命令）：[Settings > Create Key](https://www.kraken.com/login-futures) 在期货界面上。完整指南： [如何创建期货 API 密钥](https://support.kraken.com/hc/en-us/articles/360022839451-How-to-create-an-API-key-for-Kraken-Futures). 授予您的工作流程所需的最低权限。对于只读监控，“查询资金”和“查询开放订单和交易”已足够。 ### 环境变量（推荐用于代理） ```bash export KRAKEN_API_KEY="your-key" export KRAKEN_API_SECRET="your-secret" export KRAKEN_FUTURES_API_KEY="your-futures-key" # 可选 export KRAKEN_FUTURES_API_SECRET="your-futures-secret" # 可选 export CHAINVECTOR_API_KEY="cv_live_..." # 用于信号 + 策略组 ``` ### 配置文件（适用于人类） 将凭证存储在 `~/.config/kraken/config.toml` 中： ```toml [auth] api_key = "your-api-key" api_secret = "your-api-secret" [settings] default_pair = "BTCUSD" output = "table" ``` 或使用交互式向导：`kraken setup`。 ### 凭证解析 优先级最高： 1. 命令行标志（`--api-key`、`--api-secret`） 2. 环境变量（`KRAKEN_API_KEY`、`KRAKEN_API_SECRET`） 3. 配置文件（`~/.config/kraken/config.toml`） ### 安全 - 配置文件以 `0600` 权限创建（仅所有者读/写） - 绝不记录、打印或在错误消息中包含机密 - 使用 `--api-secret-stdin` 或 `--api-secret-file` 而不是 `--api-secret` 以避免进程列表中的机密 - 自动化时，优先使用环境变量而非命令行标志 <details> <summary>高级：API 端点覆盖</summary> | 变量 | 默认值 | 描述 | |----------|---------|-------------| | `KRAKEN_SPOT_URL` | `https://api.kraken.com` | 现货 REST API 基本 URL | | `KRAKEN_FUTURES_URL` | `https://futures.kraken.com/derivatives/api/v3` | 期货 REST API 基本 URL | | `KRAKEN_WS_PUBLIC_URL` | `wss://ws.kraken.com/v2` | 公共 WebSocket 端点 | | `KRAKEN_WS_AUTH_URL` | `wss://ws-auth.kraken.com/v2` | 身份验证现货 WebSocket 端点 | | `KRAKEN_WS_L3_URL` | `wss://ws-l3.kraken.com/v2` | 3 级订单簿 WebSocket 端点 | | `KRAKEN_FUTURES_WS_URL` | `wss://futures.kraken.com/ws/v1` | 期货 WebSocket 端点 | | `CHAINVECTOR_URL` | `https://chainvector.com/api/v1` | ChainVector REST API 基本 URL | 解析：CLI 标志 > 环境变量 > 默认值。仅接受 `https://` 和 `wss://` 方案。 </details> ## MCP 服务器 `kraken-cli` 包括一个内置的 [Model Context Protocol](https://modelcontextprotocol.io/) 服务器通过 stdio。无需子进程包装器。 MCP 工具调用通过与 CLI 命令相同的路径，并继承相同的错误处理和速率限制行为。 > [!WARNING] > MCP 是本地优先的，设计用于您自己的机器。任何连接到此 MCP 服务器的代理都使用相同的配置 Kraken 账户和 API 密钥权限。不要公开、隧道或共享此服务器超出您控制的系统。始终使用 `https://` 和 `wss://` 端点。按照 alpha 版本使用此集成。 ```bash kraken mcp # 只读为读-仅限（市场、账户、纸张、信号、策略） kraken mcp -s all # 所有服务，危险调用需要确认 = true kraken mcp -s all --allow-dangerous # 所有服务，无需逐一确认 kraken mcp -s market,paper,signals,strategy # 指定服务 ``` 配置您的 MCP 客户端（Claude Desktop、ChatGPT、Codex、Gemini CLI、Cursor、VS Code、Windsurf 等）： ```json { "mcpServers": { "kraken": { "command": "kraken", "args": ["mcp", "-s", "market,paper,signals,strategy"], "env": { "CHAINVECTOR_API_KEY": "cv_live_YOUR_KEY" } } } } ``` ### 服务组 | 服务 | 认证 | 风险 | |---------|------|------| | market | 否 | 无 | | account | Kraken | 只读 | | trade | Kraken | 订单（危险） | | funding | Kraken | 提现（危险） | | earn | Kraken | 质押（危险） | | subaccount | Kraken | 转账（危险） | | futures | 混合 | 订单（危险） | | futures-paper | 否 | 无（模拟） | | paper | 否 | 无（模拟） | | signals | ChainVector | 只读智能 | | strategy | ChainVector | 只读顾问（永远不会下订单） | | auth | 否 | 只读 | 默认：`market,account,paper,signals,strategy`。MCP v1 中排除流媒体组（`websocket`、`futures-ws`）。 危险工具带有 `destructive_hint` 注释，包括 `[DANGEROUS: requires human confirmation]` 在描述中。在默认保护模式下，危险调用必须包括 `acknowledged=true`。在自主模式 (`--allow-dangerous`) 下，此要求被禁用。 <details> <summary>输出和错误</summary> ### JSON (`-o json`) 主要输出格式。每个命令返回有效的 JSON。 ```bash kraken ticker BTCUSD -o json # {"BTCUSD":{"a":["67234.10","1","1.000"],"b":["67234.00","1","1.000"],...}} ``` WebSocket 命令使用 NDJSON（每行一个 JSON 对象）进行流式传输。 ### 表格 (`-o table`) 人类可读的表格。 `-o` 未指定时为默认值。 ``` ┌──────────┬──────────┬──────────┬──────────┬────────────┐ │ Pair │ Ask │ Bid │ Last │ Volume ... │ ├──────────┼──────────┼──────────┼──────────┼────────────┤ │ BTCUSD │ 67234.10 │ 67234.00 │ 67234.10 │ 1234.56 │ └──────────┴──────────┴──────────┴──────────┴────────────┘ ``` ### 错误信封 失败时，stdout 包含一个 JSON 信封，带有稳定的 `error` 类别： ```json {"error": "auth", "message": "Authentication failed: EAPI:Invalid key"} ``` 路由到 `error` 而不是 `message`。`message` 字段是人类可读的且不稳定。 | 类别 | 可重试 | 操作 | |----------|-----------|--------| | `auth` | 否 | 检查 API 密钥和机密 | | `rate_limit` | 是 | 错误包含 `suggestion`，带有特定于层级的限制、`docs_url` 指向 Kraken 文档，以及 `retryable` 标志。阅读 `suggestion` 并调整策略。 | | `network` | 是 | 指数级退化，最大 5 次重试 | | `validation` | 否 | 修复输入参数 | | `api` | 否 | 检查请求和参数 | | `config` | 否 | 检查配置文件或环境变量 | | `websocket` | 是 | 使用渐进式回退和安全预算重新连接（每个流生命周期最多 12 次重新连接尝试） | | `io` | 否 | 检查文件路径和权限 | | `parse` | 否 | 记录原始响应，可能的 API 维护 | 完整的错误目录，包含信封和回退策略：[agents/error-catalog.json](agents/error-catalog.json)。 ###详细模式 (`-v`) 请求/响应诊断信息发送到 stderr，保持 stdout 清洁： ```bash kraken balance -o json -v 2>/dev/null | jq . ``` </details> ## 命令列表 15 个组中的 189 条命令。有关机器可读的参数模式，请加载 [agents/tool-catalog.json](agents/tool-catalog.json)。 | 组 | 命令 | 认证 | 描述 | |-------|----------|------|-------------| | 市场 | 10 | 否 | 币种行情、订单簿、K线、交易记录、资产信息 | | 账户 | 18 | Kraken | 余额、订单、交易记录、账本、仓位、导出 | | 交易 | 9 | Kraken | 订单创建、修改、取消（现货、xStocks、外汇） | | 资金 | 10 | Kraken | 存入、提取、钱包转账 | | 收益 | 6 | Kraken | 质押策略和分配 | | 子账户 | 2 | Kraken | 创建子账户、账户间转账 | | 期货 | 39 | 混合 | 期货市场数据和交易 | | 期货模拟 | 17 | 否 | 期货模拟交易，价格实时更新 | | 期货WebSocket | 9 | 混合 | 期货WebSocket流式数据 | | WebSocket | 15 | 混合 | 现货WebSocket v2 流式数据和请求/响应 | | 模拟 | 10 | 否 | 现货模拟交易，价格实时更新 | | 信号 | 32 | ChainVector | ChainVector市场情报：趋势、动量、概率、大户流动、爆仓、资金、仓位 | | 策略 | 6 | ChainVector | 综合交易顾问：集成、动量、均值回归、挤压、瀑布、套利 | | 认证 | 4 | 否 | 凭证管理 | | 实用工具 | 2 | 否 | 交互式设置和REPL shell | 34 条命令被标记为 `dangerous`（订单、提款、转账、取消所有、质押）。权威列表是 [agents/tool-catalog.json](agents/tool-catalog.json) 中的 `dangerous` 字段。 <details> <summary>完整命令参考</summary> ### 市场数据（公开） | 命令 | 描述 | |---------|-------------| | `kraken status` | 系统状态 | | `kraken server-time` | 服务器时间 | | `kraken assets [--asset BTC,ETH] [--asset-class CLASS]` | 资产信息 | | `kraken pairs [--pair BTCUSD] [--asset-class CLASS]` | 可交易货币对 | | `kraken ticker <PAIR...> [--asset-class tokenized_asset\|forex]` | 币种行情 | | `kraken ohlc <PAIR> [--interval 60] [--asset-class tokenized_asset\|forex]` | K线数据 | | `kraken orderbook <PAIR> [--count 25] [--asset-class tokenized_asset]` | 订单簿 | | `kraken orderbook-grouped <PAIR> [--depth 10] [--grouping 1]` | 分组订单簿 | | `kraken trades <PAIR> [--count 1000] [--asset-class tokenized_asset]` | 交易记录 | | `kraken spreads <PAIR> [--since TS] [--asset-class tokenized_asset]` | 最近的价差 | ### 账户数据（私有） | 命令 | 描述 | |---------|-------------| | `kraken orderbook-l3 <PAIR> [--depth 100]` | L3订单簿 | | `kraken balance [--rebase-multiplier rebased\|base]` | 所有余额 | | `kraken extended-balance` | 扩展余额（余额、信用、冻结） | | `kraken credit-lines [--rebase-multiplier rebased\|base]` | 信用额度详情（VIP） | | `kraken trade-balance [--asset USD] [--rebase-multiplier rebased\|base]` | 保证金/权益摘要 | | `kraken open-orders [--trades] [--cl-ord-id ID] [--rebase-multiplier rebased\|base]` | 开仓订单 | | `kraken closed-orders [--start TS] [--end TS] [--offset N] [--userref REF] [--cl-ord-id ID] [--closetime open\|close\|both] [--consolidate-taker] [--without-count] [--rebase-multiplier rebased\|base]` | 已平仓订单 | | `kraken query-orders <TXID...> [--trades] [--userref REF] [--consolidate-taker] [--rebase-multiplier rebased\|base]` | 查询特定订单 | | `kraken trades-history [--type TYPE] [--trades] [--offset N] [--consolidate-taker] [--without-count] [--ledgers] [--rebase-multiplier rebased\|base]` | 交易记录 | | `kraken query-trades <TXID...> [--trades] [--rebase-multiplier rebased\|base]` | 查询特定交易 | | `kraken positions [--txid ID] [--show-pnl] [--consolidation market] [--rebase-multiplier rebased\|base]` | 开仓仓位 | | `kraken ledgers [--asset BTC --type trade] [--asset-class CLASS] [--start TS] [--end TS] [--offset N] [--without-count] [--rebase-multiplier rebased\|base]` | 账本记录 | | `kraken query-ledgers <ID...> [--trades] [--rebase-multiplier rebased\|base]` | 查询特定账本记录 | | `kraken volume [--pair BTCUSD] [--rebase-multiplier rebased\|base]` | 交易量和手续费 | | `kraken export-report --report trades --description "desc" [--format CSV\|TSV] [--fields F] [--starttm TS] [--endtm TS]` | 请求导出 | | `kraken export-status --report trades` | 导出状态 | | `kraken export-retrieve <ID>` | 下载导出 | | `kraken export-delete <ID>` | 删除导出 | ### 交易 | 命令 | 描述 | |---------|-------------| | `kraken order buy <PAIR> <VOL> [--type limit --price P] [--asset-class tokenized_asset] [--validate] ...` | 买入订单 | | `kraken order sell <PAIR> <VOL> [--type limit --price P] [--asset-class tokenized_asset] [--validate] ...` | 卖出订单 | | `kraken order batch <JSON_FILE> [--pair P] [--asset-class tokenized_asset] [--deadline DL] [--validate]` | 批量订单（2-15） | | `kraken order amend --txid <TXID> [--order-qty Q --limit-price P ...]` | 修改订单 | | `kraken order amend --cl-ord-id <ID> [--limit-price P ...]` | 按客户订单ID修改 | | `kraken order edit <TXID> [--price P]` | 编辑订单（取消+替换） | | `kraken order cancel <TXID...>` | 按交易ID取消 | | `kraken order cancel --cl-ord-id <ID>` | 按客户订单ID取消 | | `kraken order cancel-batch <TXID...> [--cl-ord-ids ID...]` | 批量取消（最多50个） | | `kraken order cancel-all [--yes]` | 取消所有 | | `kraken order cancel-after <SECS>` | 看门狗 | ### 资金 | 命令 | 描述 | |---------|-------------| | `kraken deposit methods <ASSET> [--asset-class currency\|tokenized_asset] [--rebase-multiplier rebased\|base]` | 存入方式 | | `kraken deposit addresses <ASSET> <METHOD> [--new] [--asset-class CLASS] [--amount AMT]` | 存入地址 | | `kraken deposit status [--asset A] [--asset-class CLASS] [--method M] [--start TS] [--end TS] [--cursor C] [--limit N] [--rebase-multiplier rebased\|base]` | 存入状态 | | `kraken withdraw <ASSET> <KEY> <AMOUNT> [--asset-class CLASS] [--address ADDR] [--max-fee F] [--rebase-multiplier rebased\|base]` | 提取资金 | | `kraken withdrawal methods [--asset A] [--asset-class CLASS] [--network N] [--rebase-multiplier rebased\|base]` | 提取方式 | | `kraken withdrawal addresses [--asset A] [--asset-class CLASS] [--method M] [--key K] [--verified true\|false]` | 提取地址 | | `kraken withdrawal info <ASSET> <KEY> <AMOUNT>` | 提取手续费信息 | | `kraken withdrawal status [--asset A] [--asset-class CLASS] [--method M] [--start TS] [--end TS] [--cursor C] [--limit N] [--rebase-multiplier rebased\|base]` | 提取状态 | | `kraken withdrawal cancel <ASSET> <REFID>` | 取消待处理提取 | | `kraken wallet-transfer <ASSET> <AMT> --from IIBAN --to IIBAN` | 钱包转账 | ### 收益 | 命令 | 描述 | |---------|-------------| | `kraken earn strategies [--asset ETH] [--lock-type flex bonded...] [--ascending] [--cursor C] [--limit N]` | 列出策略 | | `kraken earn allocate <ID> <AMT>` | 分配资金 | | `kraken earn deallocate <ID> <AMT>` | 解除分配 | | `kraken earn allocate-status <ID>` | 分配状态 | | `kraken earn deallocate-status <ID>` | 解除分配状态 | | `kraken earn allocations [--ascending] [--converted-asset USD] [--hide-zero-allocations]` | 当前分配 | ### 子账户 | 命令 | 描述 | |---------|-------------| | `kraken subaccount create <USERNAME> <EMAIL>` | 创建子账户 | | `kraken subaccount transfer <ASSET> <AMOUNT> --from IIBAN --to IIBAN [--asset-class CLASS]` | 账户间转账 | ### 期货：公共市场数据 | 命令 | 描述 | |---------|-------------| | `kraken futures instruments` | 所有合约 | | `kraken futures tickers` | 所有行情 | | `kraken futures ticker <SYMBOL>` | 单个行情 | | `kraken futures orderbook <SYMBOL>` | 订单簿 | | `kraken futures history <SYMBOL> [--since TS] [--before TS]` | 交易记录 | | `kraken futures feeschedules` | 手续费时间表 | | `kraken futures instrument-status [--symbol SYM]` | 合约状态 | ### 期货：交易（私有） | 命令 | 描述 | |---------|-------------| | `kraken futures order buy <SYM> <SIZE> [--type limit] [--price P] [--stop-price SP] [--trigger-signal mark\|index\|last] [--client-order-id ID] [--reduce-only] [--trailing-stop-max-deviation V] [--trailing-stop-deviation-unit percent\|quote_currency]` | 买入期货 | | `kraken futures order sell <SYM> <SIZE> [--type limit] [--price P] [--stop-price SP] ...` | 卖出期货 | | `kraken futures edit-order --order-id ID [--size S] [--price P] [--stop-price SP]` | 修改现有订单 | | `kraken futures cancel --order-id ID` | 按订单ID取消 | | `kraken futures cancel --cli-ord-id ID` | 按客户订单ID取消 | | `kraken futures cancel-all [--symbol SYM] [--yes]` | 取消所有订单 | | `kraken futures cancel-after <SECS>` | 看门狗 | | `kraken futures batch-order '<JSON>'` 或 `kraken futures batch-order @file.json` | 批量订单创建 | ### 期货：账户数据（私有） | 命令 | 描述 | |---------|-------------| | `kraken futures accounts` | 钱包/账户信息 | | `kraken futures open-orders` | 开仓订单 | | `kraken futures positions` | 开仓仓位 | | `kraken futures fills [--since TS]` | 最近的成交 | | `kraken futures leverage [--symbol SYM]` | 杠杆偏好 | | `kraken futures set-leverage <SYMBOL> <MAX_LEVERAGE>` | 设置杠杆 | | `kraken futures notifications` | 账户通知 | | `kraken futures transfers` | 转账记录 | | `kraken futures transfer <AMOUNT> <CURRENCY>` | 钱包间转账 | | `kraken futures history-executions [--since TS] [--before TS] [--sort asc\|desc]` | 执行历史 | | `kraken futures history-orders [--since TS] [--before TS] [--sort asc\|desc]` | 订单历史 | | `kraken futures history-triggers [--since TS] [--before TS] [--sort asc\|desc]` | 触发历史 | | `kraken futures history-account-log-csv [--since TS] [--before TS]` | 账户日志（CSV） | | `kraken futures trading-instruments [--contract-type ...]` | 交易工具（认证） | | `kraken futures historical-funding-rates <SYMBOL>` | 历史资金费率 | | `kraken futures order-status <ORDER_ID>...` | 查询订单状态（认证） | | `kraken futures pnl-preferences` | 获取PnL偏好（认证） | | `kraken futures set-pnl-preference <SYMBOL> <PREFERENCE>` | 设置PnL偏好（认证） | | `kraken futures unwind-queue` | 获取 unwind 队列（认证） | | `kraken futures assignment-programs` | 赋值程序（认证） | | `kraken futures fee-schedule-volumes` | 手续费时间表容量（认证） | | `kraken futures subaccounts` | 列出子账户（认证） | | `kraken futures subaccount-status <UID>` | 子账户交易状态（认证） | | `kraken futures set-subaccount-status <UID> <ENABLED>` | 设置子账户交易状态（认证） | | `kraken futures wallet-transfer <FROM> <TO> <UNIT> <AMOUNT>` | 钱包间转账（认证） | ### 期货：模拟交易（无需认证） | 命令 | 描述 | |---------|-------------| | `kraken futures paper init [--balance 10000] [--currency USD] [--fee-rate 0.0005]` | 初始化期货模拟账户 | | `kraken futures paper reset [--balance B] [--currency C] [--fee-rate R]` | 重置账户（清除仓位、订单、成交） | | `kraken futures paper balance` | 抵押品、占用保证金、可用保证金、未实现盈亏 | | `kraken futures paper status` | 账户摘要：权益、启动以来盈亏、未实现盈亏、仓位/订单数量 | | `kraken futures paper buy <SYM> <SIZE> [--leverage L] [--type TYPE] [--price P] [--stop-price SP] [--trigger-signal mark\|index\|last] [--client-order-id ID] [--reduce-only] [--trailing-stop-max-deviation V] [--trailing-stop-deviation-unit percent\|quote_currency]` | 模拟做多（所有8种订单类型） | | `kraken futures paper sell <SYM> <SIZE> [--leverage L] [--type TYPE] [--price P] ...` | 模拟做空（所有8种订单类型） | | `kraken futures paper orders` | 开仓订单 | | `kraken futures paper order-status <ID>` | 查询特定订单 | | `kraken futures paper edit-order --order-id <ID> [--size S] [--price P] [--stop-price SP]` | 修改开仓订单 | | `kraken futures paper cancel --order-id <ID>` | 按订单ID取消 | | `kraken futures paper cancel-all [--symbol SYM]` | 取消所有（可选符号过滤） | | `kraken futures paper batch-order '<JSON>'` | 批量订单创建 | | `kraken futures paper positions` | 开仓仓位 | | `kraken futures paper fills [--since TS]` | 成交记录 | | `kraken futures paper history` | 已平仓位和已取消订单，显示已实现盈亏 | | `kraken futures paper leverage [--symbol SYM]` | 当前杠杆偏好 | | `kraken futures paper set-leverage <SYM> <LEV>` | 设置杠杆 | ### 期货WebSocket流式数据 | 命令 | 描述 | |---------|-------------| | `kraken futures ws ticker <MARKET...>` | 流式期货行情（公开） | | `kraken futures ws trades <MARKET...>` | 流式期货成交（公开） | | `kraken futures ws book <MARKET...>` | 流式期货订单簿（公开） | | `kraken futures ws fills` | 流式成交（私有，挑战认证） | | `kraken futures ws open-orders` | 流式开仓订单（私有） | | `kraken futures ws open-positions` | 流式开仓仓位（私有） | | `kraken futures ws balances` | 流式余额和保证金（私有） | | `kraken futures ws notifications` | 流式通知（私有） | | `kraken futures ws account-log` | 流式账户日志（私有） | ### WebSocket（流式和请求/响应） | 命令 | 描述 | |---------|-------------| | `kraken ws ticker <PAIR...> [--event-trigger bbo]` | 流式行情 | | `kraken ws trades <PAIR...>` | 流式成交 | | `kraken ws book <PAIR...> [--depth 10]` | 流式订单簿 | | `kraken ws ohlc <PAIR...> [--interval 1]` | 流式K线 | | `kraken ws instrument [PAIR...]` | 流式合约元数据 | | `kraken ws executions` | 流式成交（认证） | | `kraken ws balances` | 流式余额更新（认证） | | `kraken ws level3 <PAIR...>` | 流式L3订单簿（认证） | | `kraken ws add-order` | 通过WebSocket下单（认证） | | `kraken ws amend-order` | 通过WebSocket修改订单（认证） | | `kraken ws cancel-order` | 通过WebSocket取消订单（认证） | | `kraken ws cancel-all` | 通过WebSocket取消所有订单（认证） | | `kraken ws cancel-after <TIMEOUT>` | 通过WebSocket看门狗（认证） | | `kraken ws batch-add` | 通过WebSocket批量下单（认证） | | `kraken ws batch-cancel` | 通过WebSocket批量取消订单（认证） | ### ChainVector 信号（只读，ChainVector 密钥） | 命令 | 描述 | |---------|-------------| | `kraken signals snapshot --symbol BTC` | 一次性机器人决策快照 | | `kraken signals regime --symbol BTC` | 市场趋势分类器，包含置信度和理由 | | `kraken signals momentum --symbol BTC [--type perp\|spot] [--exchanges LIST]` | 跨市场动量 -100..+100 | | `kraken signals lead-lag --symbol BTC [--window 5m\|10m\|30m]` | 哪个市场先动 | | `kraken signals probability --symbol BTC-USDT [--target P] [--horizon 15m] [--kind terminal\|touch\|range]` | 概率引擎 | | `kraken signals volatility --symbol BTC-USDT [--window W] [--horizon H] [--percentile]` | 实现波动率电池，预期变动区间 | | `kraken signals indicators --symbol BTC-USDT [--interval 15m] [--indicators rsi,macd]` | 服务器端RSI、EMA/MA、MACD、ATR、布林线 | | `kraken signals risk-index [--symbol BTC] [--history]` | 0-100 市场压力综合指数 | | `kraken signals whale-pressure --symbol BTC` | 净大户买入/卖出压力 | | `kraken signals whale-trades --symbol BTC` | 单个大额成交 | | `kraken signals cascade-risk --symbol BTC` | 清算级联概率 | | `kraken signals liquidations --symbol BTC` | 最近的清算流动 | | `kraken signals heatmap --symbol BTC` | 清算集群水平 | | `kraken signals funding --symbol BTC` | 跨市场资金费率 | | `kraken signals funding-weighted --symbol BTC` | 资金费率加权综合指数 | | `kraken signals funding-squeeze --symbol BTC` | 多头/空头挤压分数 | | `kraken signals funding-arbitrage` | 跨市场套利对 | | `kraken signals basis --symbol BTC` | 现货-期货基差 | | `kraken signals positioning --symbol BTC` | 持仓量、资金费率、多头/空头综合指数 | | `kraken signals long-short --symbol BTC` | 多头/空头比率 | | `kraken signals cvd --symbol BTC` | 累积交易量delta | | `kraken signals book-imbalance --symbol BTC` | 订单簿不平衡 | | `kraken signals book-walls --symbol BTC` | 大额挂单 | | `kraken signals open-interest --symbol BTC` | 跨市场持仓量 | | `kraken signals screener` | 排名所有跟踪的资产 | | `kraken signals history --symbol BTC-USDT [--limit N]` | 历史区间 | | `kraken signals options-probability --symbol BTC-USDT` | 期权隐含概率 | | `kraken signals prediction-markets` | 跟踪的预测市场 | | `kraken signals prediction-quotes` | 预测市场报价 | | `kraken signals prediction-stability` | 报价稳定性诊断 | | `kraken signals prediction-edge` | 模型-市场优势 | | `kraken signals status` | ChainVector API 健康状况和权益 | </details> ### ChainVector 策略顾问（只读，ChainVector 密钥） | 命令 | 描述 | |---------|-------------| | `kraken strategy advise --symbol BTC [--horizon-min 15] [--max-risk-index 65]` | 全套策略：状态门控 + EV 加权 + 否决栈 | | `kraken strategy momentum --symbol BTC [--min-score 55] [--min-breadth 0.7]` | 动量持续性检查 | | `kraken strategy meanrev --symbol BTC [--rsi-oversold 30] [--rsi-overbought 70]` | 均值回归检查 | | `kraken strategy squeeze --symbol BTC [--min-score 60]` | 资金挤压策略 | | `kraken strategy cascade-fade --symbol BTC [--min-score 60]` | 渐进式清算.CASCADE 策略 | | `kraken strategy carry [--base BTC] [--min-spread-apr 0.05]` | Delta 中性资金策略扫描 | ### 实用工具 | 命令 | 描述 | |---------|-------------| | `kraken setup` | 交互式设置向导 | | `kraken shell` | 交互式 REPL | | `kraken auth set/show/test/reset` | 凭证管理 | </details> ## 模拟交易 模拟交易提供了一个安全的沙盒环境，用于在真实的Kraken价格下测试交易逻辑。无需API密钥，无需账户，无需真实资金。两个独立的模拟引擎分别覆盖现货和期货。 ### 现货模拟交易 命令接口与现货交易几乎相同。通过更改前缀在模拟和真实之间切换：`kraken paper buy` vs `kraken order buy`。已知差异：模拟仅支持`market`和`limit`订单类型；不模拟滑点和部分成交。 **代理模式：** ```bash kraken paper init --balance 10000 -o json kraken paper buy BTCUSD 0.01 -o json kraken paper sell BTCUSD 0.005 --type limit --price 70000 -o json kraken paper status -o json kraken paper reset -o json ``` **人工模式：** ```bash kraken paper init --balance 5000 --currency EUR kraken paper buy BTCUSD 0.01 kraken paper balance kraken paper status kraken paper orders kraken paper history kraken paper reset ``` | 命令 | 描述 | |---------|-------------| | `kraken paper init [--balance 10000] [--currency USD]` | 初始化模拟账户 | | `kraken paper reset` | 重新核对挂单，然后重置 | | `kraken paper balance` | 所有余额（总计、预留、可用） | | `kraken paper buy <PAIR> <VOL> [--type limit --price P]` | 模拟买入（市价或限价） | | `kraken paper sell <PAIR> <VOL> [--type limit --price P]` | 模拟卖出（市价或限价） | | `kraken paper orders` | 开仓限价订单 | | `kraken paper cancel <ORDER_ID>` | 取消限价订单 | | `kraken paper cancel-all` | 取消所有限价订单 | | `kraken paper history` | 成交交易历史 | | `kraken paper status` | 投资组合价值、未实现盈亏、交易次数 | 价格来自公共的Kraken Ticker API（无需身份验证）。所有成交均适用0.26%的吃单手续费（Kraken Starter 级别默认）。限价订单在市场价格穿越订单价格时立即成交。 所有输出均在表格模式下标记为 `[PAPER]`，在 JSON 模式下包含 `"mode": "paper"`。 ### 期货模拟交易 与实时 `kraken futures order` 命令几乎相同。支持所有 8 种订单类型（市价、限价、post、止损、止盈、ioc、跟踪止损、fok）、杠杆和保证金跟踪、仓位聚合/净额、清算模拟和资金费率累积。已知差异：`order-status` 仅接受单个 ID（实时接受多个），post-only 订单被取消，而不是模拟 maker 队列优先级，成交使用 bid/ask 快照，无深度滑点，不模拟部分成交。通过将 `futures paper` 替换为 `futures order` 在模拟和实时之间切换。 成功 JSON 响应包含 `"mode": "futures_paper"`。大多数表格视图标记为 `[FUTURES PAPER]` 或 `[FP]`。 **代理模式：** ```bash kraken futures paper init --balance 10000 -o json kraken futures paper buy PF_XBTUSD 1 --leverage 10 --type market -o json kraken futures paper sell PF_ETHUSD 5 --leverage 20 --type market -o json kraken futures paper positions -o json kraken futures paper status -o json kraken futures paper reset -o json ``` **人工模式：** ```bash kraken futures paper init --balance 10000 --currency USD kraken futures paper buy PF_XBTUSD 1 --leverage 10 --type market kraken futures paper sell PF_XBTUSD 1 --leverage 10 --type limit --price 70000 kraken futures paper positions kraken futures paper balance kraken futures paper fills kraken futures paper history kraken futures paper reset ``` | 命令 | 描述 | |---------|-------------| | `kraken futures paper init [--balance B] [--currency C] [--fee-rate R]` | 初始化期货模拟账户 | | `kraken futures paper reset [--balance B] [--currency C] [--fee-rate R]` | 重置账户（清除仓位、订单、成交） | | `kraken futures paper balance` | 抵押品、已用保证金、可用保证金、未实现盈亏 | | `kraken futures paper status` | 权益、自启动以来盈亏、未实现盈亏、仓位/订单数量 | | `kraken futures paper buy <SYM> <SIZE> [--leverage L] [--type TYPE] ...` | 模拟做多（所有 8 种订单类型） | | `kraken futures paper sell <SYM> <SIZE> [--leverage L] [--type TYPE] ...` | 模拟做空（所有 8 种订单类型） | | `kraken futures paper orders` | 开仓挂单 | | `kraken futures paper order-status <ID>` | 查询特定订单 | | `kraken futures paper edit-order --order-id <ID> [--size S] [--price P] [--stop-price SP]` | 编辑挂单 | | `kraken futures paper cancel --order-id <ID>` | 取消订单（也支持 `--cli-ord-id`） | | `kraken futures paper cancel-all [--symbol SYM]` | 取消所有（可选符号过滤） | | `kraken futures paper batch-order '<JSON>'` | 批量订单放置 | | `kraken futures paper positions` | 开仓仓位，标记价格，清算，盈亏 | | `kraken futures paper fills [--since TS]` | 成交历史 | | `kraken futures paper history` | 已关闭仓位和已取消订单 | | `kraken futures paper leverage` | 当前杠杆偏好 | | `kraken futures paper set-leverage <SYM> <LEV>` | 按符号设置默认杠杆 | 价格来自公共的Kraken期货行情API（无需身份验证）。模拟吃单手续费。仓位跟踪杠杆、保证金和清算价格。根据公共资金费率API累积资金费率。现货模拟和期货模拟完全独立：重置一个不会影响另一个。 ## 示例 ### 基于实时价格的条件订单 ```bash PRICE=$(kraken ticker BTCUSD -o json | jq -r '.[].c[0]') kraken order buy BTCUSD 0.001 --type limit --price "$PRICE" -o json ``` ### 投资组合再平衡检查 ```bash BTC=$(kraken balance -o json | jq -r '.BTC // "0"') if [ "$(echo "$BTC > 0.001" | bc)" -eq 1 ]; then kraken order sell BTCUSD 0.001 --type market -o json fi ``` ### 实时价格流 ```bash kraken ws ticker BTC/USD -o json | while read -r line; do LAST=$(echo "$line" | jq -r '.data[0].last // empty') [ -n "$LAST" ] && echo "BTC: $LAST" done ``` ### 流式传输多个行情 ```bash kraken ws ticker BTC/USD ETH/USD SOL/USD -o json ``` ### 看门狗 ```bash kraken order cancel-after 60 ``` 如果CLI在60秒内未重置计时器，则取消所有开仓订单。 ## 代理技能 配备了53种代理技能，涵盖ChainVector信号情报、交易策略、市场分析和投资组合管理。参见完整的 [技能索引](skills/INDEX.md)。 <details> <summary>故障排除</summary> **macOS 阻止二进制文件（"Apple 无法验证"）** ```bash xattr -d com.apple.quarantine /usr/local/bin/kraken ``` **"EAPI:Invalid key" 或身份验证错误** 检查 `KRAKEN_API_KEY` 和 `KRAKEN_API_SECRET` 是否设置正确。密钥区分大小写。验证 API 密钥是否具有命令所需的权限（`balance` 查询资金，`order buy` 修改订单等）。 **速率限制错误** CLI 不会预先限制或重试速率限制的请求。Kraken API 服务器强制执行速率限制，CLI 会立即返回错误，`suggestion` 字段包含特定于层的限制和指向 Kraken 文档的相关 `docs_url`。阅读建议并调整请求频率。对于持续高频使用，优先使用 WebSocket 流式传输而不是 REST 轮询。 **MCP 客户端中未找到工具** 验证 `kraken` 是否在您的 PATH 上。运行 `kraken mcp -s market` 以确认服务器启动。检查您的客户端配置是否与 [MCP 服务器](#mcp-server) 部分中的 JSON 格式匹配。 **现货模拟交易状态错误** 运行 `kraken paper reset` 以清除并重新初始化。 **期货模拟交易状态错误** 运行 `kraken futures paper reset` 以清除并重新初始化。现货和期货模拟状态是独立的。 </details> <details> <summary>架构</summary> ``` src/ main.rs -- CLI 入口点，clap 解析，退出代码 lib.rs -- AppContext，共享调度器，模块重新导出 auth.rs -- HMAC-SHA512 签名（现货 + 期货），随机数管理 config.rs -- 配置文件 I/O，凭证解析，秘密包装器 client.rs -- 具有瞬时错误重试和丰富速率限制错误的 HTTP 客户端 chainvector.rs -- ChainVector API 客户端（身份验证，重试，信封解析） errors.rs -- 统一错误类型，基于类别的 JSON 信封 paper.rs -- 现货模拟交易状态引擎（本地模拟） futures_paper.rs -- 期货模拟交易引擎（杠杆，保证金，清算，资金） shell.rs -- 具有 rustyline 的交互式 REPL telemetry.rs -- 代理客户端识别，实例跟踪，用户代理 commands/ -- 每个命令组的模块 mod.rs -- 模块重新导出 helpers.rs -- 共享实用程序（JSON 提取，输出格式化） market.rs -- 公共市场数据 account.rs -- 私人账户数据 trade.rs -- 现货交易 funding.rs -- 存款，取款，钱包转账 earn.rs -- 质押/赚取 subaccount.rs -- 子账户管理 futures.rs -- 期货交易和市场数据 futures_paper.rs -- 期货模拟交易命令 futures_ws.rs -- 期货 WebSocket v1 流式传输 websocket.rs -- 现货 WebSocket v2 流式传输 paper.rs -- 现货模拟交易命令 signals.rs -- ChainVector 信号情报命令 strategy.rs -- ChainVector 策略顾问命令 auth.rs -- 凭证管理命令 utility.rs -- 设置向导 mcp/ -- 内置 MCP 服务器 mod.rs -- 服务组解析，流式传输排除过滤器 server.rs -- ServerHandler 实现，工具调度，基于环境的 URL 解析 registry.rs -- 从 clap 树 + tool-catalog.json 构建的工具注册表 schema.rs -- 从 clap 参数元数据生成的 JSON 架构 output/ -- 渲染层 mod.rs -- 格式调度，CommandOutput 类型 table.rs -- 人类可读的表格输出 json.rs -- JSON 输出和 NDJSON 流式传输 ``` </details> ## 开发 ```bash cargo build # 开发构建 cargo test # 运行测试 cargo clippy -- -D warnings # 校验 ``` ## 贡献 欢迎提交错误报告、功能请求和拉取请求。参见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。 ## 许可证和免责声明 MIT。参见 [LICENSE](LICENSE)。 这是实验性软件。命令与实时Kraken交易所交互，可能导致真实金融交易。订单、提款和转账一旦处理就不可逆转。作者不对金融损失承担任何责任。参见 [DISCLAIMER.md](DISCLAIMER.md) 获取完整条款。