Alpaca 是一个面向智能体调用的交易工具连接器，封装 Alpaca 的 Trading API，用于在 Alpaca 平台上进行股票、加密货币和期权交易。该连接器为独立、非官方工具，与 Alpaca 无隶属、背书或赞助关系。
用途
该连接器用于通过 Alpaca 的 Trading API 执行交易相关操作，包括：查看账户余额与购买力、列出持仓与未实现盈亏、查看投资组合历史与账户活动（成交、股息、费用）、检查市场是否开市；下单与管理股票、加密货币或期权订单（市价/限价/止损/括号/OCO/OTO/多腿）；替换或取消未成交订单；平仓或清仓持仓；行使期权持仓；查询资产的可交易性、可做空性、可分数化；列出资产或期权合约；读取自选列表。
主要能力
连接器包含 25 个脚本，覆盖账户、订单、持仓、资产、期权和自选列表。具体脚本包括：getAccount（账户余额、购买力、权益、交易权限标志）、getAccountConfigurations（账户交易配置标志）、getPortfolioHistory（权益与盈亏时间序列）、listAccountActivities（按类型和日期列出账户活动）、placeOrder（下单买卖股票、加密货币对或期权）、replaceOrder（修改未成交订单的数量、价格或有效期）、cancelOrder（按 id 取消单个订单）、cancelAllOrders（尝试取消所有未成交订单）、listOrders（按状态、代码或方向筛选订单）、getOrder（按 id 获取订单状态与成交详情）、getOrderByClientOrderId（按自定义 client_order_id 获取订单）、listPositions（列出所有持仓及市值、成本基础、盈亏）、getPosition（按代码或资产 id 获取单个持仓）、closePosition（全部或部分平仓）、closeAllPositions（清仓所有持仓，可选先取消未成交订单）、exerciseOptionsPosition（按期权代码或合约 id 行使期权持仓）、listAssets（按类别、状态或交易所列出可交易资产）、getAsset（按代码、资产 id 或 CUSIP 获取资产及可交易性标志）、getClock（市场时钟，是否开市及下次开市/收市时间）、getMarketCalendar（日期范围内的交易日及开收市时间）、listOptionContracts（按标的、到期日、类型、行权价列出期权合约）、getOptionContract（按 OCC 代码或合约 id 获取期权合约）、listWatchlists（列出自选列表）、getWatchlist（按 id 获取自选列表及资产代码）、getWatchlistByName（按名称获取自选列表及资产代码）。
使用方式
该连接器是一个 agentskills.io 技能。若尚未安装为技能，可先使用 npx skills add zapier/connectors --skill alpaca 安装（或使用所在运行环境的技能安装机制）。安装技能会复制文件，但不包含依赖。在运行 CLI、本地 MCP 服务器或 zapier-sdk 认证命令前，需先在此处运行一次 npm install --omit=dev。若将已发布包作为依赖导入自己的项目，该 npm install 已解析所有依赖，参见 references/use-as-sdk.md。连接器运行于 Node.js 22.18+。根据运行方式加载对应参考文件：MCP 客户端加载 references/use-as-mcp.md；终端/子进程访问加载 references/use-as-cli.md；仅在自己的代码中作为依赖导入加载 references/use-as-sdk.md；无工具访问、无终端、无法导入包时加载 references/use-as-recipe.md。所有脚本使用单一连接 alpaca。交易工具默认访问 paper 主机，实盘需显式启用。认证通过连接选择器传递，格式为 [<resolver>:]<value> 字符串，而非密钥本身。每个连接器接受 zapier:<connection-id>（Zapier 管理的认证），部分也接受直接令牌解析器。Zapier 管理的认证对 Alpaca 为实验性，直接解析器（alpaca:<PREFIX>）为已验证路径。每个脚本返回 { data, meta } 信封，meta.outputDataValidation 指示验证情况。可通过跳过输出验证获取原始结果，或通过 jq 表达式过滤输出数据。
适用场景
适用于需要通过智能体或自动化流程在 Alpaca 上进行交易操作、账户与持仓查询、资产与期权合约查询、市场时钟与日历查询以及自选列表读取的场景。默认在模拟环境运行，适合测试与开发；实盘交易需显式启用。
限制
该连接器有意不支持以下操作：资金转移（存款、取款、转账、银行链接或资金注入，属于 Alpaca Broker API 范围）；读取市场数据（报价、K 线、快照、新闻、公司行动、期权链，属于 Market Data API 范围）；创建或修改自选列表，或更改账户配置（仅读取）；默认对实盘账户交易（除非用户显式启用实盘）；管理股票筛选器、OAuth 应用或账户文档。若被要求执行这些操作，应告知用户不支持并停止，不应使用其他工具替代。金额与数量值以字符串返回以保留小数精度，不应强制转换为数字。下单为异步确认：placeOrder 确认接收，状态可能服务端变化，需在断言成交前重新查询 getOrder。交易与持仓工具基于精确的代码或 id，而非公司名称；若用户给出公司名称，需先用 getAsset 或 listAssets 解析，若多个匹配则列出并询问，不应猜测代码。自选列表按名称解析，名称在账户内唯一，精确（不区分大小写）匹配即为答案。订单/持仓需使用用户已有的 order_id 或代码，若描述模糊则先列出候选并确认。