技能介绍

先说清楚问题有多贵

金融 bug 是沉默的。Alpaca 的 wire format 里，价格、数量、名义金额都是 JSON 字符串（如 "190.2345"），这个设计是有意的——绕开 JSON 二进制浮点带来的精度损失。但你的代码里几乎一定会有人随手写 float(amount) 或 Number(amount)，一次算账出错，可能要等到对账时才被发现。

核心规则只有一条：凡是会动钱的路径，数字永远不许以 IEEE-754 float 的形式存在。

技能如何帮你兜住这个坑

技能是一份 opinionated 的清单，语言无关，重点覆盖三层：

解析与序列化：字符串金额必须解析成十进制类型——Python 用 decimal.Decimal，TS/JS 用 decimal.js 或字符串算术，Go 用 shopspring/decimal，Java 用 BigDecimal。序列化回字符串，禁止 float() / Number() 进入 money path。
发送前显式取整：现金金额通常只收 2 位小数，碎股 qty/notional 最多 9 位。超额精度可能被拒或被对方静默取整。规则是调用 API 之前就显式取整，且明确选 rounding mode——往外转钱一律 truncate（向下取整，如 floor(amount * 100) / 100），不能继承语言默认的浮点格式化行为。每步中间运算后都要重新取整。
存储与审计：数据库用定点小数列（如 DECIMAL(20, 8)），同时原样保存 Alpaca 返回的原始字符串，即使为了 API 调用截断到 2 位，也把完整精度留着，对账时才能对得上。显式维护 currency 列。

注意点与边界

端点不一致：并非所有 Alpaca 端点都返回字符串——比如 bar OHLC 这类行情数据可能是 JSON number。展示/分析用 float 可以接受，动钱和存储不行。先确认你碰的字段属于哪一类。
碎股下单：qty 与 notional 二选一，不能同时传；不要拿自己抓的价格反推 qty 再传，直接传 notional 让 Alpaca 算 fill，否则引入漂移。
多币种盲区：大部分 Broker/trading 流是 USD，但 funding wallet 支持 USD/EUR/JPY 等，还有 FX 费用。碰 funding 时永远不要假设 USD。

建议前置阅读 alpaca-broker-integration 技能；下单规则见 alpaca-broker-trading-orders，journal/转账见 alpaca-broker-journals 与 alpaca-broker-funding-transfers，对账见 alpaca-broker-reconciliation-idempotency。