Back to Details

helius-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Helius Wallet API Skill

Helius Wallet API Skill

Use this skill to run Helius Wallet API operations through 
uxc
+ OpenAPI.
Reuse the 
uxc
skill for shared execution, auth, and error-handling guidance.
使用该Skill通过
uxc
+ OpenAPI执行Helius Wallet API操作。
复用
uxc
Skill以获取共享的执行、认证和错误处理指引。

Prerequisites

前提条件

  • uxc
    is installed and available in 
    PATH
    .
  • Network access to 
    https://api.helius.xyz
    .
  • Access to the curated OpenAPI schema URL: 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/helius-openapi-skill/references/helius-wallet.openapi.json
  • A Helius API key.
  • uxc
    已安装且可在
    PATH
    中访问。
  • 可访问
    https://api.helius.xyz
    的网络权限。
  • 可访问精心整理的OpenAPI Schema URL： 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/helius-openapi-skill/references/helius-wallet.openapi.json
  • 一个Helius API密钥。

Scope

适用范围

This skill covers a read-first Helius Wallet API surface:
  • wallet identity lookup
  • batch identity lookup
  • wallet balances
  • wallet history
  • wallet transfers
  • wallet funding source lookup
This skill does not cover:
  • Helius RPC, DAS, or WebSocket surfaces
  • transaction submission
  • webhook setup
  • the broader Helius platform beyond the selected wallet intelligence endpoints
该Skill覆盖Helius Wallet API的只读优先接口：
  • 钱包身份查询
  • 批量身份查询
  • 钱包余额查询
  • 钱包历史记录查询
  • 钱包转账记录查询
  • 钱包资金来源查询
该Skill不覆盖以下内容：
  • Helius RPC、DAS或WebSocket接口
  • 交易提交
  • Webhook设置
  • 除所选钱包智能端点外的更广泛Helius平台功能

Authentication

认证

Helius accepts API keys by query parameter or header. This skill standardizes on 
X-Api-Key
header auth.
Configure one API-key credential and bind it to 
api.helius.xyz
:
bash
uxc auth credential set helius \
  --auth-type api_key \
  --api-key-header X-Api-Key \
  --secret-env HELIUS_API_KEY

uxc auth binding add \
  --id helius \
  --host api.helius.xyz \
  --scheme https \
  --credential helius \
  --priority 100
Validate the active mapping when auth looks wrong:
bash
uxc auth binding match https://api.helius.xyz
Helius支持通过查询参数或请求头传递API密钥。本Skill标准化使用
X-Api-Key
请求头认证。
配置一个API密钥凭证并绑定到
api.helius.xyz
：
bash
uxc auth credential set helius \
  --auth-type api_key \
  --api-key-header X-Api-Key \
  --secret-env HELIUS_API_KEY

uxc auth binding add \
  --id helius \
  --host api.helius.xyz \
  --scheme https \
  --credential helius \
  --priority 100
当认证出现问题时，验证当前的映射关系：
bash
uxc auth binding match https://api.helius.xyz

Core Workflow

核心工作流程

  1. Use the fixed link command by default:
    • command -v helius-openapi-cli
    • If missing, create it:
      bash
      uxc link helius-openapi-cli https://api.helius.xyz \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/helius-openapi-skill/references/helius-wallet.openapi.json
    • helius-openapi-cli -h
  2. Inspect operation schema first:
    • helius-openapi-cli get:/v1/wallet/{wallet}/identity -h
    • helius-openapi-cli post:/v1/wallet/batch-identity -h
    • helius-openapi-cli get:/v1/wallet/{wallet}/balances -h
  3. Prefer narrow validation before broader reads:
    • helius-openapi-cli get:/v1/wallet/{wallet}/identity wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
    • helius-openapi-cli get:/v1/wallet/{wallet}/funded-by wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
    • helius-openapi-cli get:/v1/wallet/{wallet}/balances wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 page=1 limit=20 showNative=true
  4. Execute with key/value parameters:
    • helius-openapi-cli post:/v1/wallet/batch-identity addresses:='["HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664"]'
    • helius-openapi-cli get:/v1/wallet/{wallet}/history wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 limit=20
    • helius-openapi-cli get:/v1/wallet/{wallet}/transfers wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 limit=20
    • For 
      addresses:='[...]'
      , keep shell quoting in mind. If your shell mangles that form, pass the JSON array as a bare positional payload instead.
  1. 默认使用固定链接命令：
    • command -v helius-openapi-cli
    • 如果不存在，创建该命令：
      bash
      uxc link helius-openapi-cli https://api.helius.xyz \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/helius-openapi-skill/references/helius-wallet.openapi.json
    • helius-openapi-cli -h
  2. 先查看操作Schema：
    • helius-openapi-cli get:/v1/wallet/{wallet}/identity -h
    • helius-openapi-cli post:/v1/wallet/batch-identity -h
    • helius-openapi-cli get:/v1/wallet/{wallet}/balances -h
  3. 优先进行窄范围验证，再执行更广泛的读取操作：
    • helius-openapi-cli get:/v1/wallet/{wallet}/identity wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
    • helius-openapi-cli get:/v1/wallet/{wallet}/funded-by wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
    • helius-openapi-cli get:/v1/wallet/{wallet}/balances wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 page=1 limit=20 showNative=true
  4. 使用键值参数执行操作：
    • helius-openapi-cli post:/v1/wallet/batch-identity addresses:='["HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664"]'
    • helius-openapi-cli get:/v1/wallet/{wallet}/history wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 limit=20
    • helius-openapi-cli get:/v1/wallet/{wallet}/transfers wallet=HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 limit=20
    • 对于
      addresses:='[...]'
      ，请注意shell的引号规则。如果你的shell破坏了该格式，可以将JSON数组作为裸位置负载传递。

Operation Groups

操作分组

Wallet Identity

钱包身份

  • get:/v1/wallet/{wallet}/identity
  • post:/v1/wallet/batch-identity
  • get:/v1/wallet/{wallet}/funded-by
  • get:/v1/wallet/{wallet}/identity
  • post:/v1/wallet/batch-identity
  • get:/v1/wallet/{wallet}/funded-by

Wallet Activity

钱包活动

  • get:/v1/wallet/{wallet}/balances
  • get:/v1/wallet/{wallet}/history
  • get:/v1/wallet/{wallet}/transfers
  • get:/v1/wallet/{wallet}/balances
  • get:/v1/wallet/{wallet}/history
  • get:/v1/wallet/{wallet}/transfers

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. Do not imply RPC write methods, transaction sending, or webhooks.
  • Helius labels the Wallet API as beta. Expect response shape drift and keep parsers focused on stable fields.
  • Start with small 
    limit
    values before paginating large histories or transfer crawls.
  • Identity and funded-by lookups can return 404-style misses for unknown wallets; treat that as a data absence case before assuming auth failure.
  • helius-openapi-cli <operation> ...
    is equivalent to 
    uxc https://api.helius.xyz --schema-url <helius_openapi_schema> <operation> ...
    .
  • 自动化操作基于JSON输出包，请勿使用
    --text
    参数。
  • 优先解析稳定字段：
    ok
    、
    kind
    、
    protocol
    、
    data
    、
    error
    。
  • 将此v1版本Skill视为只读工具。请勿尝试使用RPC写入方法、交易发送或Webhook相关功能。
  • Helius将Wallet API标记为beta版本。响应格式可能会发生变化，请确保解析器专注于稳定字段。
  • 在分页查询大量历史记录或转账数据前，先使用较小的
    limit
    值进行测试。
  • 身份查询和资金来源查询可能会对未知钱包返回类似404的结果；请将此视为数据缺失情况，而非认证失败。
  • helius-openapi-cli <operation> ...
    等同于 
    uxc https://api.helius.xyz --schema-url <helius_openapi_schema> <operation> ...
    。

References

参考资料