kraken-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Kraken REST Skill

Kraken REST Skill

Use this skill to run Kraken public market-data operations through
uxc
+ OpenAPI.
Reuse the
uxc
skill for shared execution, auth, and error-handling guidance.
使用该Skill通过
uxc
+ OpenAPI执行Kraken公开市场数据操作。
复用
uxc
Skill以获取通用的执行、认证和错误处理指南。

Prerequisites

前提条件

  • uxc
    is installed and available in
    PATH
    .
  • Network access to
    https://api.kraken.com
    .
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/kraken-openapi-skill/references/kraken-public.openapi.json
  • 已安装
    uxc
    且其可在
    PATH
    中访问。
  • 可访问
    https://api.kraken.com
    的网络权限。
  • 可访问以下精心整理的OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/kraken-openapi-skill/references/kraken-public.openapi.json

Scope

适用范围

This skill covers a curated Kraken public surface for:
  • server time
  • asset pair metadata
  • ticker reads
  • OHLC candles
  • order book snapshots
This skill does not cover:
  • private account or trade endpoints in v1
  • Kraken FIX
  • broader non-core platform products
该Skill涵盖Kraken的以下公开功能:
  • 服务器时间
  • 交易对元数据
  • 行情数据读取
  • OHLC蜡烛图
  • 订单簿快照
该Skill涵盖:
  • v1版本中的私有账户或交易端点
  • Kraken FIX
  • 更广泛的非核心平台产品

Authentication

认证方式

Public market endpoints in this skill do not require credentials.
Kraken private REST endpoints use provider-specific header signing and nonce handling. Keep this v1 skill public-data-only until a reusable Kraken signer flow exists in
uxc
.
本Skill中的公开市场端点无需凭证。
Kraken私有REST端点使用提供商特定的头部签名和随机数处理。在
uxc
中实现可复用的Kraken签名流程之前,本v1版本Skill仅支持公开数据操作。

Core Workflow

核心工作流

  1. Use the fixed link command by default:
    • command -v kraken-openapi-cli
    • If missing, create it:
      uxc link kraken-openapi-cli https://api.kraken.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/kraken-openapi-skill/references/kraken-public.openapi.json
    • kraken-openapi-cli -h
  2. Inspect operation help before execution:
    • kraken-openapi-cli get:/0/public/Time -h
    • kraken-openapi-cli get:/0/public/Ticker -h
  3. Prefer narrow pair reads first:
    • kraken-openapi-cli get:/0/public/Ticker pair=XBTUSD
    • kraken-openapi-cli get:/0/public/Depth pair=XBTUSD count=20
  1. 默认使用固定链接命令:
    • command -v kraken-openapi-cli
    • 若不存在则创建:
      uxc link kraken-openapi-cli https://api.kraken.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/kraken-openapi-skill/references/kraken-public.openapi.json
    • kraken-openapi-cli -h
  2. 执行前查看操作帮助:
    • kraken-openapi-cli get:/0/public/Time -h
    • kraken-openapi-cli get:/0/public/Ticker -h
  3. 优先选择特定交易对的读取操作:
    • kraken-openapi-cli get:/0/public/Ticker pair=XBTUSD
    • kraken-openapi-cli get:/0/public/Depth pair=XBTUSD count=20

Operations

操作列表

  • get:/0/public/Time
  • get:/0/public/AssetPairs
  • get:/0/public/Ticker
  • get:/0/public/OHLC
  • get:/0/public/Depth
  • get:/0/public/Time
  • get:/0/public/AssetPairs
  • get:/0/public/Ticker
  • get:/0/public/OHLC
  • get:/0/public/Depth

Guardrails

注意事项

  • Keep automation on the JSON output envelope; do not use
    --text
    .
  • Parse stable fields first:
    ok
    ,
    kind
    ,
    protocol
    ,
    data
    ,
    error
    .
  • Treat this v1 skill as read-only.
  • Kraken pair naming can differ from other venues. Check
    AssetPairs
    before assuming symbol strings.
  • kraken-openapi-cli <operation> ...
    is equivalent to
    uxc https://api.kraken.com --schema-url <kraken_public_openapi_schema> <operation> ...
    .
  • 自动化操作请使用JSON输出格式;请勿使用
    --text
    参数。
  • 优先解析稳定字段:
    ok
    kind
    protocol
    data
    error
  • 将本v1版本Skill视为只读工具。
  • Kraken的交易对命名可能与其他平台不同。在使用符号字符串前请先查看
    AssetPairs
  • kraken-openapi-cli <operation> ...
    等价于
    uxc https://api.kraken.com --schema-url <kraken_public_openapi_schema> <operation> ...

References

参考资料