用途:该技能用于通过 uxc + OpenAPI 调用 Alchemy Prices API,属于只读、仅限价格查询的 v1 版本,复用 uxc 技能的通用执行、认证与错误处理方式。
主要能力:支持三个操作——get:/tokens/by-symbol(按符号查询价格)、post:/tokens/by-address(按合约地址查询价格)、post:/tokens/historical(查询历史价格)。不覆盖节点 JSON-RPC、NFT/组合 API、写操作、更广的 Alchemy API 面以及单次调用多符号批量查询。
使用方式:前置条件是 uxc 已安装并在 PATH 中,可访问 https://api.g.alchemy.com 与精选 OpenAPI schema URL,并拥有 Alchemy API 密钥。认证上,密钥出现在请求路径 /prices/v1/{apiKey}/...,需用 --secret-env 或 --secret-op 配置路径前缀模板并绑定到 api.g.alchemy.com。核心流程:先检查或创建 alchemy-openapi-cli 链接命令,再查看操作 schema,最后从窄范围单资产读取开始。POST 端点使用位置 JSON 参数。
限制与注意:保持 JSON 输出信封,勿用 --text,优先解析 ok、kind、protocol、data、error;密钥因出现在路径中而敏感,避免写在 shell 历史中;by-symbol 实际为查询式且支持重复参数,但本 v1 因 uxc 对数组型查询参数处理不可靠而收窄为单个 symbols;历史请求时间窗口不宜过大。