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.
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
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
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:
CODEBLOCK0
Validate the active mapping when auth looks wrong:
CODEBLOCK1
Core Workflow
- 1. Use the fixed link command by default:
-
command -v helius-openapi-cli
- If missing, create it:
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
- INLINECODE9
- 2. Inspect operation schema first:
-
helius-openapi-cli get:/v1/wallet/{wallet}/identity -h
-
helius-openapi-cli post:/v1/wallet/batch-identity -h
- INLINECODE12
- 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
- INLINECODE15
- 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.
Operation Groups
Wallet Identity
- - INLINECODE20
- INLINECODE21
- INLINECODE22
Wallet Activity
- - INLINECODE23
- INLINECODE24
- INLINECODE25
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.
- INLINECODE33 is equivalent to
uxc https://api.helius.xyz --schema-url <helius_openapi_schema> <operation> ....
References
- - Usage patterns: INLINECODE35
- Curated OpenAPI schema: INLINECODE36
- Helius authentication docs: https://www.helius.dev/docs/api-reference/authentication
- Helius Wallet API docs: https://www.helius.dev/docs/api-reference/wallet-api
Helius 钱包 API 技能
使用此技能通过 uxc + OpenAPI 运行 Helius 钱包 API 操作。
复用 uxc 技能以获取共享执行、认证和错误处理指导。
前提条件
- - uxc 已安装并可在 PATH 中使用。
- 可访问 https://api.helius.xyz 的网络连接。
- 可访问精选的 OpenAPI 模式 URL：
- https://raw.githubusercontent.com/holon-run/uxc/main/skills/helius-openapi-skill/references/helius-wallet.openapi.json
范围
此技能涵盖以读取为主的 Helius 钱包 API 接口：
- - 钱包身份查询
- 批量身份查询
- 钱包余额
- 钱包历史记录
- 钱包转账记录
- 钱包资金来源查询
此技能不涵盖：
- - Helius RPC、DAS 或 WebSocket 接口
- 交易提交
- Webhook 设置
- 除选定钱包智能端点之外的更广泛 Helius 平台
认证
Helius 通过查询参数或请求头接受 API 密钥。此技能统一使用 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 HELIUSAPIKEY
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
核心工作流程
- 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. 首先检查操作模式：
- 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 数组。
操作分组
钱包身份
- - get:/v1/wallet/{wallet}/identity
- post:/v1/wallet/batch-identity
- get:/v1/wallet/{wallet}/funded-by
钱包活动
- - get:/v1/wallet/{wallet}/balances
- get:/v1/wallet/{wallet}/history
- get:/v1/wallet/{wallet}/transfers
安全护栏
- - 自动化操作应基于 JSON 输出格式；不要使用 --text。
- 优先解析稳定字段：ok、kind、protocol、data、error。
- 将此 v1 技能视为只读。不要暗示 RPC 写入方法、交易发送或 webhook。
- Helius 将钱包 API 标记为测试版。预期响应结构可能发生变化，解析器应专注于稳定字段。
- 在分页处理大量历史记录或转账爬取之前，先使用较小的 limit 值。
- 身份和资金来源查询可能因未知钱包返回 404 类型的缺失结果；在假设认证失败之前，先将其视为数据缺失情况。
- helius-openapi-cli <操作> ... 等同于 uxc https://api.helius.xyz --schema-url openapischema> <操作> ...。
参考资料
- - 使用模式：references/usage-patterns.md
- 精选 OpenAPI 模式：references/helius-wallet.openapi.json
- Helius 认证文档：https://www.helius.dev/docs/api-reference/authentication
- Helius 钱包 API 文档：https://www.helius.dev/docs/api-reference/wallet-api
