现货 API
新手？请先设置身份验证。
所有私有端点都需要签名请求。在进行第一次调用之前，请阅读身份验证指南。公共端点（市场数据、订单簿）无需凭证。
API 版本
当前现货 API 为 v4。本节所有端点均通过以下地址提供：
https://api.btse.com/spot/api/v4/
旧版 v3.3
先前的 v3.3 现货 API 仍可供现有集成使用。可在交互式 现货（旧版 v3.3）API 浏览器 中查看，其 OpenAPI 规范可从 /specs/spot-rest.openapi.yaml 下载。新集成请使用 v4。
环境
| Product | Production | Testnet |
|---|---|---|
| Spot REST | https://api.btse.com/spot | https://testapi.btse.io/spot |
| Spot WebSocket | wss://ws.btse.com/ws/spot | wss://testws.btse.io/ws/spot |
| Spot OSS | wss://ws.btse.com/ws/oss/spot | wss://testws.btse.io/ws/oss/spot |
OSS（Order Stream Service）端点专用于订单簿增量更新。
公共市场数据（订单簿、行情、K 线等）现已迁移至市场数据 API。
频率限制
| 类别 | 每个 API | 每个用户 |
|---|---|---|
| 查询 | 15 req/s | 30 req/s |
| 订单 | 75 req/s | 75 req/s |
超出限制会触发分级封禁：1 秒 → 5 分钟 → 15 分钟。所有 429 响应中都包含 Retry-After 标头。详见频率限制。
发现可交易币对
调用 市场信息（无需身份验证）获取所有可用市场：
curl https://api.btse.com/public-api/market/v1/markets
每个条目包含交易对名称和交易约束：
| 字段 | 用途 |
|---|---|
symbol | 所有 API 调用中使用的市场标识符（例如 BTC-USD） |
active | 如果市场当前开放交易则为 true |
base / quote | 交易对中的两种货币 |
minOrderSize / maxOrderSize | 订单数量限制 |
minPriceIncrement | 最小价格变动单位 — 您的价格必须是此值的倍数 |
minSizeIncrement | 最小数量变动单位 — 您的数量必须是此值的倍数 |
交易对命名规则
| 产品 | 格式 | 示例 |
|---|---|---|
| 现货 | BASE-QUOTE | BTC-USD, ETH-USDT |
| 合约 (v3) | BASE-PERP | BTC-PERP, ETH-PERP |
| 合约 (旧版) | 拼接格式 | BTCPFC（在 FIX 中使用 ApplyNewSymbolName: Y 以获取新名称） |
对于价格极小的加密资产，市场数据使用 K/M/B 前缀（例如 K_PEIPEI），但钱包 API 始终使用不带前缀的原始名称（与 base 字段匹配）。
API 状态码
请参阅通用的错误码参考，了解 HTTP 状态码和内部 API 枚举值。
API 枚举
订单状态码、订单类型码和其他数字枚举记录在错误码 → API Status Enum 中。