SuperAPI AI 工具集

helius-openapi-skill

数据与分析

查看项目

更新于 10-15 22:14

技能介绍

用途:通过 uxc 与精选 OpenAPI 架构执行 Helius Wallet API 的只读操作,复用 uxc 的共享执行、认证与错误处理指引。

主要能力:覆盖钱包身份查询、批量身份查询、钱包余额、钱包历史、钱包转账、钱包资金来源查询。不覆盖 Helius RPC、DAS、WebSocket、交易提交、Webhook 设置及所选钱包情报端点之外的更广平台。

前置条件:uxc 已安装并在 PATH 中;可访问 https://api.helius.xyz;可访问精选 OpenAPI 架构 URL;拥有 Helius API key。

认证:Helius 支持查询参数或请求头传 API key,本技能统一使用 X-Api-Key 头。配置凭证并绑定到 api.helius.xyz: 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 可用 uxc auth binding match https://api.helius.xyz 校验映射。

使用方式:默认使用固定链接命令 helius-openapi-cli;若缺失则用 uxc link 创建并指向架构 URL。先查看操作架构,如 helius-openapi-cli get:/v1/wallet/{wallet}/identity -h。执行时以键值参数传入,例如 wallet=...、page=1 limit=20 showNative=true;批量身份用 addresses:='["..."]',注意 shell 引号,必要时改传裸位置 JSON 数组。

限制与注意:保持自动化使用 JSON 输出信封,不要用 --text;优先解析稳定字段 ok、kind、protocol、data、error。本 v1 技能视为只读,不应暗示 RPC 写方法、发送交易或 Webhook。Helius 将 Wallet API 标为 beta,响应结构可能漂移,解析器应聚焦稳定字段。大历史或转账抓取前先用小 limit。身份与 funded-by 查询对未知钱包可能返回 404 式未命中,应先视为数据缺失而非认证失败。helius-openapi-cli <operation> ... 等价于 uxc https://api.helius.xyz --schema-url <helius_openapi_schema> <operation> ...。参考:references/usage-patterns.md、references/helius-wallet.openapi.json、Helius 认证文档与 Wallet API 文档。