现货 API 总览
状态：已实现。
Rocky 现货 API 是一套兼容 Binance Spot 的接口，用于交易 Rocky 的链上现货市场。现成的 Binance Spot 客户端代码只需少量、有据可查的改动即可移植；每处差异都会在受影响的页面上单独说明，并汇总于 与 Binance 的差异。
与中心化现货交易所相比，它有两点根本不同：
- 链下撮合，链上结算。 订单在 Rocky 的撮合引擎中撮合；客户账户之间的每一笔成交随后以两腿原子 DvP 转账的形式在 Canton Network 上交割，并获得一个可独立验证的
cantonUpdateId；交易所上的每个订单事件和每笔成交（含自营账户）还会按 epoch 承诺到 Canton，并提供公开的包含证明。见 链上结算 与 Epoch 承诺。 - 两种签名方案。 经典的 HMAC-SHA256 共享密钥，或 Ed25519 密钥——后者 Rocky 只持有你的公钥。见 基本信息。
接口面
| 接口面 | 路径前缀 | 鉴权 | 页面 |
|---|---|---|---|
| 行情 REST | GET /api/v3/{ping,time,exchangeInfo,depth,trades,klines,ticker/24hr} | 无（按 IP 限流） | 行情接口 REST |
| 交易与账户 REST | /api/v3/{order,openOrders,allOrders,myTrades,account} | X-MBX-APIKEY + 签名 | 交易接口 REST |
| 会话类 REST | POST /api/v3/session-key、POST /api/v3/dev/faucet、POST /v1/spot/transfer、/v1/spot-chain/member-auth* | 交易所钱包会话 bearer token（无需 API key） | 会话与资金划转、MemberAuth |
| 行情 WebSocket | wss://…/ws/<stream>、wss://…/stream?streams=… | 无（按 IP 限制连接数） | WebSocket 行情推送 |
没有用户数据 WebSocket 流，也没有 WebSocket 下单接口；账户与订单状态只能通过 REST 获取。
用自己的 Canton party 交易？请先读 外部做市商指南：它解释了你的 validator 承担的每笔成交 Canton 流量成本，以及结算对账接口。
Base URL
| 环境 | REST | WebSocket |
|---|---|---|
| 生产 | https://api.rocky.exchange | wss://api.rocky.exchange |
| 沙盒 | 见你的 集成包（Integration Pack） | 见你的集成包 |
与永续合约 API 的关系
现货 API（/api/v3/*）与永续合约 FAPI（/fapi/*，见 永续合约）共用同一套 API key、同一个签名校验器、同一个限流器和同一张错误码表。一个 API key 的请求权重预算横跨两个接口面。现货交易对使用 Rocky 原生命名（CBTC-USDCB）；/api/v3 上没有 Binance 风格的交易对映射。
交易对与资产
- 现货交易对为大写、带连字符、大小写敏感：
CBTC-USDCB、CETH-CBTC。 - 资产名可以包含点号（
USDC.B）；交易对名则永远不包含（CBTC-USDCB的quoteAsset为USDC.B）。资产名请从exchangeInfo读取，不要通过拆分交易对名推断。 - WebSocket 流名使用小写交易对，且保留连字符：
cbtc-usdcb@trade。
如何阅读本章节
每个页面都带有状态标注，遵循本站约定：
- 已实现 —— Rocky 当前已提供此端点；页面根据网关源码给出精确的请求与响应结构。
- 空缺（暂未实现） —— 页面记录 Binance 的方法/路径与计划范围，方便 SDK 开发者一眼看出差距（例如 增量深度信息流）。
页面中的示例响应值仅为示意；字段名、嵌套结构以及字符串/数字类型均为精确值。