SuperAPI AI 工具集

alchemy-openapi-skill

数据与分析

查看项目

更新于 11-02 00:28

技能介绍

用途:本技能用于通过 uxc 和 OpenAPI 模式执行 Alchemy Prices API 的读取操作,聚焦代币价格查询这一较窄的能力范围。

主要能力:v1 版本仅覆盖三项操作:按符号查询代币价格(get:/tokens/by-symbol)、按合约地址查询代币价格(post:/tokens/by-address)、查询历史代币价格(post:/tokens/historical)。该技能明确不覆盖节点 JSON-RPC、NFT 或投资组合 API、写操作、更广泛的 Alchemy API 范围,以及单次 uxc 调用中的多符号批量查询。

前置条件:需要 uxc 已安装并位于 PATH;能够访问 https://api.g.alchemy.com;可访问精选 OpenAPI 模式 URL(https://raw.githubusercontent.com/holon-run/uxc/main/skills/alchemy-openapi-skill/references/alchemy-prices.openapi.json);以及一个 Alchemy API key。

认证方式:Alchemy Prices API 将 API key 放在请求路径中(/prices/v1/{apiKey}/...)。配置单个 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 校验当前映射。

使用方式:默认使用固定链接命令 command -v alchemy-openapi-cli;若缺失则通过 uxc link 创建。先查看操作模式,例如 alchemy-openapi-cli get:/tokens/by-symbol -h。示例调用包括按符号查询(alchemy-openapi-cli get:/tokens/by-symbol symbols=ETH currency=USD)、按地址查询(POST 端点使用位置 JSON,包含 addresses 与 currency)以及历史价格查询(POST 端点,含 symbol、startTime、endTime、interval、currency)。该命令行操作等价于 uxc https://api.g.alchemy.com --schema-url <模式> <operation>。

适用场景与限制:适合只读的代币价格自动化查询,建议先做单资产窄查询再扩展历史请求;历史查询时间窗口应保持紧凑。自动化应保持 JSON 输出信封,不要使用 --text,优先解析 ok、kind、protocol、data、error 等稳定字段。API key 出现在请求路径中属敏感信息,应尽量使用 --secret-env 或 --secret-op 而非明文。由于当前 uxc 查询参数处理对数组形参数不够可靠,该技能将 by-symbol 端点有意收窄为单个 symbols=<TOKEN> 查询,尽管实时 API 支持重复 symbols 参数。