SuperAPI AI 工具集

alchemy-openapi-skill

数据与分析

查看项目

更新于 10-16 08:48

技能介绍

用途:该技能用于通过 uxc 加 OpenAPI 的方式执行 Alchemy Prices API 操作,复用 uxc 的共享执行、认证与错误处理能力。

主要能力:v1 版本仅覆盖窄范围的 Prices API,包括按符号查询代币价格、按合约地址查询代币价格、查询历史代币价格。不覆盖节点 JSON-RPC、NFT 或投资组合 API、写操作、更广泛的 Alchemy API 面,以及单次 uxc 调用中的多符号批量查询。

使用方式:需先安装 uxc 并确保在 PATH 中,具备对 https://api.g.alchemy.com 的网络访问、精选 OpenAPI schema URL 以及 Alchemy API Key。认证方面,Alchemy Prices API 将 API Key 放在请求路径中,需配置带路径前缀模板的凭据: uxc auth credential set alchemy-prices
--auth-type api_key
--secret-env ALCHEMY_API_KEY
--path-prefix-template "/prices/v1/{{secret}}" uxc auth binding add
--id alchemy-prices
--host api.g.alchemy.com
--scheme https
--credential alchemy-prices
--priority 100 可用 uxc auth binding match https://api.g.alchemy.com 验证映射。默认使用固定链接命令 alchemy-openapi-cli,若缺失则通过 uxc link 创建,并用 -h 查看操作 schema。支持的操作有 get:/tokens/by-symbol、post:/tokens/by-address、post:/tokens/historical。

适用场景与限制:适合需要读取 Alchemy 代币价格数据的自动化流程。防护规则要求保持 JSON 输出信封、不使用 --text,优先解析 ok、kind、protocol、data、error 等稳定字段;视为只读且仅限价格,不暗示支持 RPC、交易执行或钱包变更。API Key 因出现在请求路径中而敏感,应尽量使用 --secret-env 或 --secret-op。该技能有意将 by-symbol 端点收窄为单个 symbols 查询,因当前 uxc 查询参数处理无法可靠执行数组形查询参数;历史请求可能快速膨胀,应保持时间窗口紧凑。