用途:该技能用于通过 uxc + OpenAPI 执行 CoinAPI REST 行情数据读取操作,复用 uxc 的共享执行、认证与错误处理指引。
主要能力:覆盖只读行情面,包括当前汇率、当前报价快照、最新 OHLCV K 线、最新成交、最新订单簿。不覆盖 FIX、WebSocket、MCP 传输面、写操作及更广泛的 CoinAPI 目录。
前置条件:uxc 已安装并在 PATH 中;可访问 https://rest.coinapi.io;可访问精选 OpenAPI 架构 URL;拥有 CoinAPI 密钥。
认证:CoinAPI 使用 X-CoinAPI-Key 请求头认证。配置一个 API 密钥凭据并绑定到 rest.coinapi.io: uxc auth credential set coinapi --auth-type api_key --api-key-header X-CoinAPI-Key --secret-env COINAPI_KEY uxc auth binding add --id coinapi --host rest.coinapi.io --scheme https --credential coinapi --priority 100 认证异常时可用 uxc auth binding match https://rest.coinapi.io 校验映射。
使用方式:默认使用固定链接命令,先检查 command -v coinapi-openapi-cli;若缺失则创建:uxc link coinapi-openapi-cli https://rest.coinapi.io --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/coinapi-openapi-skill/references/coinapi-market.openapi.json。随后用 -h 查看操作架构,并以键值参数执行,例如 coinapi-openapi-cli get:/v1/ohlcv/{symbol_id}/latest symbol_id=BINANCE_SPOT_BTC_USDT period_id=1DAY limit=10。
操作:get:/v1/exchangerate/{asset_id_base}/{asset_id_quote}、get:/v1/quotes/current、get:/v1/ohlcv/{symbol_id}/latest、get:/v1/trades/{symbol_id}/latest、get:/v1/orderbooks/{symbol_id}/latest。
限制与护栏:自动化应保持 JSON 输出信封,不要使用 --text;优先解析稳定字段 ok、kind、protocol、data、error;该 v1 技能视为只读,不应暗示支持下单或市场连接;除非用户明确要求更大拉取,否则保持 filter_symbol_id、period_id、limit、limit_levels 较窄。coinapi-openapi-cli <operation> ... 等价于 uxc https://rest.coinapi.io --schema-url <coinapi_openapi_schema> <operation> ...。参考:references/usage-patterns.md、references/coinapi-market.openapi.json、https://docs.coinapi.io/market-data/rest-api。