mcpField
A
alpaca

alpaca

github.com/starchild-ai-agent其他2971 次安装1 周前更新
代码仓库

关于 alpaca

alpaca 是通过 Alpaca REST API 查询账户、行情、持仓和订单的命令行技能。它区分模拟与实盘配置，并要求实盘下单时显式确认。

主要功能

  1. 01模拟与实盘账户配置
  2. 02查询账户与持仓
  3. 03获取报价和历史数据
  4. 04提交市价与限价订单
  5. 05命令输出为 JSON

适用场景

  1. 01查看账户状态和持仓
  2. 02查询股票报价或历史数据
  3. 03执行模拟交易
  4. 04确认后提交实盘订单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill alpaca

安装后在 Claude Code 中输入/alpaca确认已加载。

附带文件_trade_report.pyscripts/alpaca_cli.py

详细介绍

这是什么

☁️ 云端代理 — Alpaca 提供公开 REST API，因此它直接在 Starchild 容器中运行，无需本地网关。支持美国股票和 ETF。

模拟盘和实盘完全隔离：不同的密钥对、不同的主机（paper-api.alpaca.markets 与 api.alpaca.markets）。模拟盘密钥在物理上无法触及实盘账户。实盘下单还额外需要 --confirm-live 标志。

获取 API 密钥

  1. 在 alpaca.markets 注册（美国券商；模拟交易免费且无需入金）。
  2. 模拟盘密钥： 登录 → 切换到 Paper Trading（左上角开关）→ Home → "API Keys" 面板 → Generate New Keys。复制 Key ID 和 Secret Key（密钥仅显示一次）。
  3. 实盘密钥（可选，真实资金）： 切换到 Live Trading → 同一个 API Keys 面板 → 生成。这与模拟盘是不同的一对密钥。
  4. 市场数据：免费的 IEX 数据源开箱即用。SIP（全市场）需要付费数据订阅。

配置（.env）

通过安全输入方式提供 — 切勿在聊天中粘贴密钥。变量：

变量是否必填说明
ALPACA_API_KEY是（模拟盘）模拟盘 Key ID
ALPACA_SECRET_KEY是（模拟盘）模拟盘 Secret
ALPACA_LIVE_API_KEY仅实盘需要实盘 Key ID
ALPACA_LIVE_SECRET_KEY仅实盘需要实盘 Secret
ALPACA_FEED否iex（默认）或 sip

用法

pip install alpaca-py（首次运行时）。所有命令均输出 JSON。默认配置文件为 paper。

python skills/alpaca/scripts/alpaca_cli.py status
python skills/alpaca/scripts/alpaca_cli.py account
python skills/alpaca/scripts/alpaca_cli.py positions
python skills/alpaca/scripts/alpaca_cli.py orders [--executions]
python skills/alpaca/scripts/alpaca_cli.py quote --symbol AAPL
python skills/alpaca/scripts/alpaca_cli.py history --symbol AAPL --period 1d --limit 90
# place (paper): qty OR notional, market OR limit
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --qty 1 --type market
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --notional 500 --type limit --limit-price 180
python skills/alpaca/scripts/alpaca_cli.py cancel --order-id <id>
# live: must add --profile live AND --confirm-live
python skills/alpaca/scripts/alpaca_cli.py --profile live --confirm-live place --symbol AAPL --side buy --qty 1

周期：1m 5m 15m 30m 1h 1d 1w 1M。Alpaca 支持小数 --notional（美元金额）订单。

注意事项

  • status 是健康检查 — 它会报告 SDK 安装状态、密钥是否存在，并对账户进行 ping 检测。请先运行它。
  • 免费 IEX 数据在非交易时段可能稀疏/延迟；仅当账户拥有付费数据源时才使用 sip。
  • 实盘交易涉及真实资金。--confirm-live 这道关卡是有意设置的；切勿自动添加它。

评论

支持 Markdown