SuperAPI AI 工具集

aipa-data

数据与分析

查看项目

更新于 10-16 08:19

技能介绍

aipa-data 是 AIPriceAction 开发的 aipa CLI 中的一个技能,用于获取原始 OHLCV 价格数据。该命令不涉及 AI 分析,也不需要 API 密钥,数据来自公开的 S3 归档。

用途

aipa-data 的核心用途是抓取原始行情数据,包括开盘价、最高价、最低价、收盘价和成交量。当用户需要价格数据、K 线数据、OHLCV 数据、历史价格或股票报价时,可使用该技能。

主要能力

数据源方面,支持越南股票(source: vn,如 VIC、VCB、FPT、HPG、VNM、MBB、TCB、CTG、VPB、HDB 等)、加密货币(source: crypto,如 BTCUSDT、ETHUSDT、BNBUSDT、SOLUSDT 等)、全球/雅虎资产(source: global/yahoo,如 AAPL、TSLA、NVDA、SPY 等)以及 SJC 黄金(source: sjc)。

时间间隔支持 1m、5m、15m、30m、1h、4h、1D(默认)、1W、2W。可通过 --limit 指定 K 线数量,或通过 --start-date 与 --end-date 指定日期范围。默认包含移动平均线,可用 --no-ma 排除;可用 --sma 或 --ema 强制指定均线类型,默认类型由 aipa config get use_sma 控制。--no-system-prompt 可去除输出中的 persona 头部。

CLI 还内置预定义自选列表(watchlist),如 VN30、VINGROUP、TM、MASAN、INDEX、CROSS,可用 aipa watchlist get <NAME> 获取成分代码,也可创建自定义列表。

使用方式

推荐使用 uvx,无需安装。每个会话首次调用使用 uvx aipa-cli@latest 刷新缓存,后续使用 uvx aipa-cli。若 uv 不可用,可用 pip install aipa-cli 安装后以 aipa 调用;若 pip 因 PEP 668 失败,可用 python3 -m pip install aipa-cli --break-system-packages。若两者都未安装,可先安装 uv:curl -LsSf https://astral.sh/uv/install.sh | sh。

基本命令格式为 aipa get-ohlcv-data TICKER [TICKERS...] [options]。示例:aipa get-ohlcv-data VCB;aipa get-ohlcv-data VCB --limit 50;aipa get-ohlcv-data BTCUSDT --interval 1h --limit 50;aipa get-ohlcv-data FPT --start-date 2025-01-01 --end-date 2025-05-01;aipa get-ohlcv-data $(aipa watchlist get VN30)。

输出分为两个流:stdout 为 OHLCV 数据表,应呈现给用户;stderr 为带结构化标记的状态消息([build]、[error]、[done])。每行数据包含日期/时间、开盘、最高、最低、收盘、成交量;启用 --ma(默认)时还包含移动平均列。

相关命令

同一 CLI 还提供 aipa ticker-list(列出可用代码及元数据)、aipa live-data(按成交额排序的最新 K 线)、aipa performers(按指标排序的涨跌榜)、aipa volume-profile(基于 1 分钟数据的成交量分布,含 POC 与价值区域)以及 aipa config(设置管理,如 use_sma、language)。这些命令同样不涉及 LLM,也无需 API 密钥。

适用场景

适合需要原始行情数据做趋势分析、波段交易、日内分析、剥头皮分析,或需要将数据导出到表格/电子表格进行解析的场景。

限制

该技能仅获取原始 OHLCV 数据,不提供 AI 分析。数据源与可用代码以 CLI 实际支持为准。关于收费、价格、平台等信息,资料中暂未提供。