用途：借助 scripts/alpaca.sh 脚本，通过 Alpaca REST API 进行交易与账户管理，覆盖股票、ETF、期权和加密货币。
主要能力：账户与组合查询（余额、权益、购买力、组合历史、成交与分红记录、市场时钟与日历）；下各类订单（市价、限价、止损、止损限价、追踪止损、括号、OCO、OTO），股票与加密的买卖，以及期权交易（买入看涨/看跌、备兑看涨、现金担保看跌、价差 Level 3 等）；期权合约查询与行权；持仓查看与平仓（可部分或全部）；行情数据（股票快照、多标的快照、K 线、活跃股与涨跌榜、新闻；期权链、K 线、最新报价与成交；加密最新报价、K 线与快照）；公司行动、资产与自选股列表管理。
使用方式：设置必需环境变量 APCA_API_KEY_ID、APCA_API_SECRET_KEY；可选 APCA_API_BASE_URL（默认纸面 https://paper-api.alpaca.markets，实盘改为 https://api.alpaca.markets）与 APCA_DATA_API_BASE_URL（默认 https://data.alpaca.markets）。加载脚本后调用：alpaca METHOD PATH [JSON_BODY]，行情请求需加 ALPACA_DATA=1 前缀。例如：alpaca GET /v2/account；alpaca POST /v2/orders '{"symbol":"AAPL","qty":"10","side":"buy","type":"market","time_in_force":"day"}'；ALPACA_DATA=1 alpaca GET /v2/stocks/AAPL/snapshot。完整端点见 references/api.md。
限制与安全：默认纸面交易，未经用户明确确认不得切换到实盘。提交订单前应展示订单 JSON 并让用户确认标的、数量、方向和类型。下股票订单前检查市场时钟（常规时段 9:30-16:00 ET，限价单可用 extended_hours:true）。大额订单前先用 GET /v2/account 核验购买力。不得提供投资建议，仅呈现数据。全平仓、取消全部订单等不可逆操作需预警。常见错误：401 检查密钥；403 纸面/实盘 URL 不匹配；422 检查购买力或标的不支持碎股；429 速率限制，Alpaca 允许每分钟 200 次请求。缺少 jq 时脚本回退到 python3 -m json.tool。