spicytrade

spicytrade

供你自己的 AI Agent 驱动的期权副驾。 订单通过你自己的 tastytrade 账户执行，并且仅限风险明确的交易；长期有效的经纪商凭据始终留在你的设备上。

现已上线：spicy.trade。

功能介绍

• 观察（/watch）：公开市场表格，展示受跟踪的美国股票和 ETF 观察列表，包含报价、隐含波动率指标（IV 排名和百分位、期限结构）、流动性和催化剂日历，以及单个标的的详情。无需账户。
• 收藏：登录会员可置顶自己的标的。
• 每日简报（/recommendations）：附带存档的期权简报。它由独立的私有工作流中的 AI 模型自动撰写，不构成个人建议。
• MCP 工具，位于 https://spicy.trade/mcp：任何 Agent 无需凭据即可连接公共层级（快照报价、催化剂、研究内容和简报）。登录会员的 Agent 还可通过会员自己的 tastytrade 连接读取账户信息并在防护机制下下单。
• 本地 spicytrade CLI：在你的设备上运行的连接器。它将经纪商凭据保存在操作系统密钥环中，并在每次请求时将其换成短期令牌。

订单如何保持安全

所有检查都在服务端执行，优先级高于模型给出的任何建议：

• 精确解析合约：依据实时期权链解析，绝不使用模型文本中的合约。
• 仅限风险明确的交易：只有借记开仓交易，或经账户验证的平仓，才会获准下单。拒绝裸卖空敞口。
• 市场保护：根据当前买价和卖价，以及经纪商要求的最小变动价位，检查限价。
• 经纪商试运行：提交任何内容之前，tastytrade 自带的试运行必须通过。这也用于检查购买力。
• 结果不明时不自动重试：如果无法确定提交或替换订单的结果，不会重试；在根据订单历史完成核对之前，账户将无法继续下单。
• 服务端不保存经纪商凭据：Worker 仅为获取市场数据保存自己的 tastytrade 凭据。账户相关路径要求调用方提供凭据，绝不会回退使用服务端凭据。

spicytrade 本身不设确认步骤；下单前出现的任何提示都来自你运行的 Agent。这些检查可以减少错误，但不能让交易变得稳妥。请参阅风险披露。

Agent 用户快速入门

无需安装，即可使用市场数据和研究功能：将 MCP 客户端指向 https://spicy.trade/mcp。

要连接你的 tastytrade 账户（macOS 或 Linux、Node.js 22+；Linux 还需要 secret-tool 用于密钥环；不支持 Windows）：

curl -fsSL https://spicy.trade/install.sh | bash

这会将一个文件安装到 ~/.local/share/spicytrade，创建 ~/.local/bin/spicytrade 的链接，然后运行 spicytrade setup；该命令会在连接你的经纪账户前征求同意。再次运行即可更新。若要由 Agent 驱动引导流程（当前 Agent 会自行注册），请使用 bash -s -- --connector-only 并遵循连接指南。Agent 可通过阅读 llms.txt 获取完整说明。

架构

• 基于 TanStack Start 和 React 构建的 Cloudflare Workers 应用，使用 D1 存储数据。
• src/domain/：纯模式和逻辑。src/server/：Cloudflare 和提供方代码。src/routes/api.*：精简的 HTTP 适配器。src/data/：浏览器持久化。src/components/：产品界面。migrations/：D1 模式。
• ops/：会员自己的设备，即 spicytrade CLI，由 tools/build-agent.mjs 构建并由 public/install.sh 安装。
• 市场数据来自 tastytrade。所有账户读取都通过 BrokerAdapter 完成；新增经纪商只需添加一个适配器文件及其 ID。
• 有关代码遵循的规则，请参阅 AGENTS.md。

npm install
npm run dev        # http://localhost:3000
npm test && npm run lint && npm run build

免责声明

spicytrade 是由个人运营的软件。它不是经纪交易商或注册投资顾问，其展示的任何内容（包括每日简报）均不构成投资建议。期权风险很高，也可能到期时一文不值。数据和 AI 输出可能有误。请阅读风险披露。与 tastytrade 无关联，也未获其认可。

许可证

MIT