Copy page

基本信息

本模块 REST API 的 Base URL、HMAC / Ed25519 签名、时间戳、recvWindow、限频、SAPI 错误包络等与其他 SAPI 接口族完全一致，详见根级 基本信息。

本页仅列出股票交易模块特有的约定。

免责声明前置条件

下单前，账户必须通过 POST /account/disclaimer 接受美股免责声明。未接受前下单会被拒绝，返回 486410（下单前请先签署交易免责声明）。

频率限制

除共享的 SAPI 权重 / IP 限制外，以下接口另有 per-UID 的请求频率上限：

接口	限额
POST /order/place	200 次 / 分钟（UID）
POST /tokenized/mint	50 次 / 分钟（UID）
POST /tokenized/redeem	50 次 / 分钟（UID）

URL 前缀

本模块所有接口共享前缀：

Code
/sapi/v1/equity/

Symbol 格式

• symbol 一律为大写美股 ticker。
• 合法示例：AAPL、NVDA、TSLA、SPY、QQQ。
• 非法示例：EQ_AAPL、AAPLUSDT、aapl。
• 服务端维护上架 symbol 列表。未知 ticker 的行为因端点而异：/order/place、/tokenized/mint 返回 -26004；/market/exchangeInfo 返回空 symbols 数组；/market/quote 返回空响应体。

报价资产（Quote Asset）

• /order/place 中 quoteAsset 省略时默认为 USDC。
• 服务端维护允许集合，提交不在集合内的值会被拒绝。

价格

• 所有价格字段隐式以 USD 计价。
• 限价单 price 最多 2 位小数，精度超出会在校验阶段被拒。

时间戳

• 请求与响应中所有时间戳字段均为 Unix epoch 毫秒数。
• 签名请求中的 timestamp 为客户端当前时间；recvWindow 与其他 SAPI 接口一致（默认 5000 ms，最大 60000 ms）。

枚举契约

• 所有枚举字符串值在请求与响应中一律 UPPERCASE（BUY / SELL、MARKET / LIMIT、FILLED / CANCELED、RTH / EXTENDED / 24H）。
• 完整枚举值集合参见 通用枚举定义。

手续费

• LIMIT BUY 下单时，服务端自动计算手续费并在下单时一并冻结；请求仅需提交 price + quantity，无需传入 fee 字段。
• 实际结算手续费在订单历史、订单详情、成交历史响应的 fee 字段中返回。