CEX API接口架构详解

文档概述

本文介绍加密货币交易所(CEX)对外提供的各类 API 接口,以 Binance 现货为例,分析不同接口的功能、特点和适用场景。

接口架构总览

CEX 通常采用分层接口架构:

  • 核心层:FIX API,服务机构客户和做市商
  • 专业层:WebSocket API(下单、查询)+ WebSocket Streams(行情推送),服务量化交易者和专业个人交易者
  • 普通层:REST API,服务普通零售用户
  • 编码选项:SBE,二进制编码,FIX API、REST / WebSocket API 的响应和行情流都可以用

以 Binance 为例(参考 Binance 现货 API 文档):

flowchart LR
    B[Binance 现货 API] --> FIX[FIX API]
    FIX --> OE[订单接入 fix-oe 9000 / 9001 / 9002]
    FIX --> DC[Drop Copy fix-dc 9000 / 9001 / 9002]
    FIX --> MD[市场数据 fix-md 9000 / 9001 / 9002]
    B --> WSAPI[WebSocket API ws-api.binance.com]
    WSAPI --> W1[下单 / 撤单 / 改单 / 查询]
    WSAPI --> W2[用户数据流 userDataStream.subscribe]
    B --> WSS[WebSocket Streams]
    WSS --> S1[JSON stream.binance.com / data-stream.binance.vision]
    WSS --> S2[SBE stream-sbe.binance.com]
    B --> REST[REST API]
    REST --> R1[api.binance.com CloudFront]
    REST --> R2[api1-api4 直连 EC2 / api-gcp]

接口对比与选择

接口功能对比

功能 FIX API WebSocket API WebSocket Streams REST API
下单 ✅ ✅ ❌ ✅
撤单 ✅ ✅ ❌ ✅
改单 ✅ ✅ ❌ ✅
批量撤单 ✅ ✅ ❌ ✅
实时行情推送 ✅ ❌(可查询) ✅ ❌(可查询)
历史数据 ❌ ✅ ❌ ✅
账户查询 ❌ ✅ ❌ ✅
订单推送 ✅(ExecutionReport) ✅(用户数据流) ❌ ❌

改单:FIX 用 OrderCancelRequestAndNewOrderSingle(撤单并重新下单)或 OrderAmendKeepPriorityRequest(只减数量、保留排队优先级);WebSocket API 对应 order.cancelReplace / order.amend.keepPriority;REST 对应 POST /api/v3/order/cancelReplace / PUT /api/v3/order/amend/keepPriority。

接口性能对比

接口类型 吞吐量 复杂度 成本
FIX SBE 极高(订单接入每 10 秒 10,000 条消息) 极高 高
FIX 文本 极高(同上) 高 高
WebSocket API 高(请求权重按 IP 累计,同一 IP 的连接共享) 中 中
WebSocket Streams 高 中 中
REST API 中 低 低

延迟主要取决于网络位置和交易所的处理时间,而不是协议本身。Binance 现货与合约的直连入口都在 AWS 东京(ap-northeast-1):2026-11-12 从 apne1-az4 实测,到 api1/api4、stream、ws-api 及合约各入口的 TCP 握手约 0.2 ms,合约 ws-fapi 的 WebSocket 请求往返约 0.9 ms(其中约 0.7 ms 为交易所处理时间)。REST 走 api.binance.com(CloudFront)或从其他区域访问时,才会到数十毫秒。

适用场景对比

用户类型 推荐接口 原因
HFT 交易公司 FIX SBE 极致性能,超低延迟
做市商 FIX API 高吞吐量,专业特性
量化交易团队 FIX 或 WebSocket API + WebSocket Streams 下单用 FIX / WebSocket API,行情用 Streams
交易机器人 WebSocket API + WebSocket Streams 下单、查询、行情都走长连接
普通交易者 REST API 简单易用,功能完整
移动应用 REST + WebSocket Streams 标准协议,易于集成
行情展示 WebSocket Streams 实时推送,低延迟

接口选择决策树

需要下单?
├─ 是 → 需要极致性能?
│      ├─ 是 → FIX API (SBE 编码, 端口 9002)
│      └─ 否 → 需要长连接、低延迟?
│             ├─ 是 → WebSocket API
│             └─ 否 → REST API
│
└─ 否 → 只需要行情?
       ├─ 机构级性能 → FIX Market Data (SBE 编码)
       ├─ 高性能推送 → WebSocket Streams (SBE)
       └─ 普通需求 → WebSocket Streams (JSON)

接口特性对比

接口性能与功能对比

接口类型 复杂度 适用对象 主要用途 Endpoint 示例
FIX API(文本) 高 机构 / 专业交易者 高频交易、做市 tcp+tls://fix-*.binance.com:9000
FIX API(SBE) 极高 顶级 HFT 极致性能场景 tcp+tls://fix-*.binance.com:9002
WebSocket API 中 量化 / 交易机器人 下单、查询、用户数据流 wss://ws-api.binance.com:443/ws-api/v3
WebSocket Streams(JSON) 中 所有用户 实时行情 wss://stream.binance.com:9443
WebSocket Streams(SBE) 高 专业用户 高性能行情推送 wss://stream-sbe.binance.com:9443
REST API 低 所有用户 普通交易、查询 https://api.binance.com、https://api1.binance.com

DNS 负载均衡策略对比

域名 策略 后端 目标用户 设计目的
api.binance.com CloudFront CDN 全球边缘节点 所有用户 全球低延迟访问
api1–api4.binance.com 直连 每个域名 2 个 EC2(东京) 延迟敏感用户 官方说明性能更好、稳定性稍差
ws-api.binance.com 多值应答 EC2 池(东京) 量化 / 机器人 下单与查询长连接
stream.binance.com 随机负载均衡 大型 EC2 池(东京) 所有用户 海量 WebSocket 连接
data-stream.binance.vision 多值应答 每次应答 8 个 IP,背后池子更大(东京) 只读用户 简单可靠的市场数据
fix-*.binance.com 加权轮询 每个域名 2 个 EC2(东京) 机构 / HFT 精确控制 + 低延迟

一、FIX API 接口

1.1 协议概述

FIX(Financial Information eXchange)是金融行业标准的电子交易协议,专为高频交易和机构级交易设计。它跑在长连接 TCP + TLS 上,不经过 HTTP。

开发工具:

  • QuickFIX:C++ / Java / Python FIX 引擎
  • SBE 工具:官方 SBE 代码生成器

关键步骤:

  • 生成 Ed25519 密钥对
  • 配置 API Key 权限
  • 实现 Logon 签名算法
  • 处理心跳和 TestRequest
  • 实现消息序列号管理
  • 处理 ExecutionReport
  • 实现错误处理和重连

1.2 三种会话类型

1.2.1 订单接入会话(Order Entry Session)

端点:

  • tcp+tls://fix-oe.binance.com:9000:FIX 文本编码
  • tcp+tls://fix-oe.binance.com:9001:FIX 请求 → FIX SBE 响应
  • tcp+tls://fix-oe.binance.com:9002:FIX SBE 请求 → FIX SBE 响应

DNS 策略:

  • Route 53 加权轮询(50:50),DNS TTL 60 秒
  • 后端为 2 个独立 EC2(ap-northeast-1):13.115.103.47、52.196.126.248
  • 建议:测试两个 IP 的延迟稳定性,选择更优的 IP 直连

支持操作:

  • 下单(NewOrderSingle)
  • 撤单(OrderCancelRequest)
  • 撤单并重新下单(OrderCancelRequestAndNewOrderSingle)
  • 保留优先级改单(OrderAmendKeepPriorityRequest)
  • 批量撤单(OrderMassCancelRequest)
  • 订单列表(NewOrderList:OCO / OTO / OTOCO)
  • 查询限制使用情况(LimitQuery)

性能指标:

  • 消息限制:每 10 秒 10,000 条消息
  • 连接限制:每账户最多 10 个并发 TCP 连接
  • 延迟:亚毫秒级(同 AZ)

权限要求:

  • API Key 必须配置 FIX_API 权限
  • 仅支持 Ed25519 密钥

1.2.2 Drop Copy 会话(订单副本会话)

端点:

  • tcp+tls://fix-dc.binance.com:9000
  • tcp+tls://fix-dc.binance.com:9001
  • tcp+tls://fix-dc.binance.com:9002

DNS 策略:

  • Route 53 加权轮询(50:50)
  • 后端为 2 个独立 EC2(ap-northeast-1):54.64.43.188、54.64.88.217

功能:

  • 接收账户所有订单的 ExecutionReport
  • 接收所有 ListStatus 消息
  • 只读模式,不支持下单或撤单

性能指标:

  • 消息限制:每 60 秒 60 条消息
  • 连接限制:每账户最多 10 个并发 TCP 连接

权限要求:API Key 可配置 FIX_API 或 FIX_API_READ_ONLY 权限。

适用场景:风控系统监控、订单审计、多系统订单同步、合规报告。

1.2.3 Market Data 会话(市场数据会话)

端点:

  • tcp+tls://fix-md.binance.com:9000
  • tcp+tls://fix-md.binance.com:9001
  • tcp+tls://fix-md.binance.com:9002

DNS 策略:

  • Route 53 加权轮询(50:50)
  • 后端为 2 个独立 EC2(ap-northeast-1):18.178.146.157、35.75.126.120

功能:

  • 市场数据流订阅
  • 活跃交易对查询
  • 不支持下单或撤单

性能指标:

  • 消息限制:每 60 秒 2,000 条消息
  • 连接限制:每账户最多 100 个并发 TCP 连接
  • 单连接最多监听 1,000 个数据流

权限要求:API Key 可配置 FIX_API 或 FIX_API_READ_ONLY 权限。

1.3 FIX 编码格式

FIX API 支持两种编码格式,通过不同端口访问。

1.3.1 FIX 文本编码(端口 9000)

特点:

  • 人类可读的文本格式
  • 字段用 SOH 字符(0x01)分隔,日志里常显示为 |
  • 便于调试和日志分析
  • 消息体积较大

示例消息:

8=FIX.4.4|9=114|35=D|34=2|49=qNXO12fH|52=20240611-09:01:46.228|56=SPOT|11=1718096506197867067|38=5|40=2|44=10|54=1|55=LTCBNB|59=4|10=016|

1.3.2 FIX SBE 编码(端口 9001 / 9002)

SBE(Simple Binary Encoding)是 FIX 组织定义的二进制编码标准。Binance 在 FIX API、REST / WebSocket API 的响应和 SBE 行情流中都使用它。

特点:

  • 二进制格式,机器高效
  • 序列化 / 反序列化更快
  • 使用 schema 文件定义消息格式
  • 需要专门的 SBE 解码器

消息结构:

<SOFH (6 字节)> <消息头 (20 字节)> <消息体 (N 字节)>

端口配置:

  • 端口 9001:发送 FIX 文本请求,接收 FIX SBE 响应(混合模式)
  • 端口 9002:发送 FIX SBE 请求,接收 FIX SBE 响应(纯 SBE 模式)

性能优势:更小的网络带宽占用、更快的消息处理、更低的 CPU 使用率,适合极致性能要求的 HFT 场景。

1.4 FIX API 核心特性

1.4.1 消息处理顺序

UNORDERED 模式(推荐):

  • 客户端消息可以按任意顺序发送到撮合引擎
  • 提供更好的并发性能
  • 适合多线程下单场景

SEQUENTIAL 模式:

  • 消息严格按 MsgSeqNum 顺序处理
  • 保证消息顺序性
  • 可能影响性能

1.4.2 响应模式

EVERYTHING 模式(默认):

  • 接收账户所有订单的 ExecutionReport
  • 包括其他连接和非 FIX API 下的订单

ONLY_ACKS 模式:

  • 仅接收 ACK 消息
  • 禁用 ExecutionReport 推送
  • 减少网络流量

1.4.3 时间同步安全

  • 所有请求需要 SendingTime 字段
  • 可选 RecvWindow 参数指定请求有效期
  • 默认 RecvWindow:Logon 请求 5,000 ms,其他请求无限制
  • 最大 RecvWindow:60,000 ms

1.4.4 连接生命周期

连接管理:

  • 会话尽可能长时间保持开放
  • 无最短连接时间保证
  • 服务器维护时会提前 10 分钟通知

心跳机制:

  • HeartBtInt 范围:5–60 秒
  • 服务器在间隔内无消息时发送 HeartBeat
  • 服务器在间隔内未收到消息时发送 TestRequest
  • 客户端必须响应 TestRequest,否则连接断开

优雅断开:

  • 客户端应发送 Logout 消息关闭会话
  • 未发送 Logout 会导致 2 倍 HeartBtInt 时间内无法重连

1.5 限制和配额

消息限制:

  • 订单接入:每 10 秒 10,000 条消息
  • Drop Copy:每 60 秒 60 条消息
  • Market Data:每 60 秒 2,000 条消息

连接限制:

  • 订单接入:30 秒内最多 15 次连接尝试,每账户最多 10 个并发 TCP 连接
  • Drop Copy:30 秒内最多 15 次连接尝试,每账户最多 10 个并发 TCP 连接
  • Market Data:300 秒内最多 300 次连接尝试,每账户最多 100 个并发 TCP 连接,单连接最多 1,000 个数据流

未成交订单计数:按账户统计,不同订单类型占用不同计数,订单完全成交后释放。

1.6 适用场景

HFT 下单操作推荐使用 FIX API 订单接入会话,并用 FIX SBE 编码(端口 9002)获得最佳性能。

最适合:高频交易(HFT)公司、做市商、机构投资者、量化交易团队、需要极致性能的专业交易者。

优势:行业标准协议、超低延迟、高吞吐量、成熟的生态系统和工具链。

劣势:学习曲线陡峭、实现复杂度高、需要专业知识、调试相对困难。

二、WebSocket 接口

Binance 的 WebSocket 接口分两类:WebSocket API(请求-响应,可下单)和 WebSocket Streams(行情推送)。

2.1 WebSocket API(下单、查询、用户数据流)

基本信息:

  • 端点:wss://ws-api.binance.com:443/ws-api/v3,443 端口不通时可用 9443
  • 请求以 JSON 文本帧发送,一帧一个请求,用 id 匹配响应
  • 单个连接有效期 24 小时
  • 签名支持 HMAC、RSA、Ed25519;使用 Ed25519 时可用 session.logon 做会话登录,之后的请求不必逐个签名
  • 响应默认 JSON;在连接 URL 加 responseFormat=sbe&sbeSchemaId=<ID>&sbeSchemaVersion=<VERSION> 可改为 SBE 响应
  • 请求权重按 IP 累计,同一 IP 的所有连接共享;订单数量限制按账户统计

主要方法:

  • 下单 / 撤单 / 改单:order.place、order.cancel、order.cancelReplace、order.amend.keepPriority
  • 批量撤单:openOrders.cancelAll
  • 账户与行情查询:account.status、depth、klines、trades.historical
  • 用户数据流:userDataStream.subscribe(已登录会话)或 userDataStream.subscribe.signature

请求示例:

{
  "id": "e2a85d9f-07a5-4f94-8d5f-789dc3deb097",
  "method": "order.place",
  "params": {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "type": "LIMIT",
    "price": "0.1",
    "quantity": "10",
    "timeInForce": "GTC",
    "timestamp": 1655716096498,
    "apiKey": "<your_api_key>",
    "signature": "<signature>"
  }
}

2.2 WebSocket Streams(JSON 编码),推荐大多数用户

基本信息:

  • 端点:wss://stream.binance.com:9443、wss://stream.binance.com:443
  • wss://data-stream.binance.vision:只有市场数据,不提供用户数据流
  • 协议:WebSocket(基于 HTTP 升级);编码:JSON 文本
  • 连接有效期 24 小时;公开市场数据无需 API Key

开发工具:ws(Node.js)、websocket-client(Python)、okhttp(Java)。

关键步骤:

  • 建立 WebSocket 连接
  • 实现 PING / PONG 处理
  • 订阅所需数据流
  • 解析 JSON 消息
  • 实现断线重连
  • 维护本地 order book

2.2.1 支持的数据流

交易数据:

  • 归集交易(@aggTrade):实时
  • 逐笔交易(@trade):实时

K 线数据:

  • UTC K 线(@kline_<interval>):1s 间隔每秒更新,其他间隔每 2 秒更新
  • 带时区偏移的 K 线(@kline_<interval>@+08:00)
  • 支持间隔:1s、1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、3d、1w、1M

Ticker 数据:

  • 精简 Ticker(@miniTicker):1000 ms
  • 完整 Ticker(@ticker):1000 ms
  • 全市场 Ticker(!miniTicker@arr、!ticker@arr)
  • 滚动窗口统计(@ticker_<window_size>):1h / 4h / 1d

深度数据:

  • 最优挂单(@bookTicker):实时
  • 有限档深度(@depth<levels>):1000 ms / 100 ms,levels = 5 / 10 / 20
  • 增量深度(@depth):1000 ms / 100 ms

其他数据:平均价格(@avgPrice):1000 ms。

2.2.2 连接管理

订阅方式:

  • 直接访问:/ws/<stream_name>
  • 组合 streams:/stream?streams=<stream1>/<stream2>/<stream3>

实时订阅 / 取消:

{"method":"SUBSCRIBE","params":["btcusdt@aggTrade","btcusdt@depth"],"id":1}
{"method":"UNSUBSCRIBE","params":["btcusdt@depth"],"id":312}
{"method":"LIST_SUBSCRIPTIONS","id":3}

心跳机制:

  • 服务器每 20 秒发送 PING
  • 客户端必须在 1 分钟内回复 PONG,否则连接断开

2.2.3 连接限制

  • 每秒最多 5 条客户端消息(包括 PING / PONG / JSON 控制消息)
  • 单连接最多订阅 1,024 个 streams
  • 每 IP 每 5 分钟最多 300 次连接
  • 超限连接会被断开;反复被断开的 IP 可能被封禁

2.2.4 时间单位

默认毫秒;在 URL 中加 timeUnit=MICROSECOND 可改为微秒:

/stream?streams=btcusdt@trade&timeUnit=MICROSECOND

2.3 WebSocket Streams(SBE 编码),高性能专业用户

基本信息:

  • 端点:wss://stream-sbe.binance.com、wss://stream-sbe.binance.com:9443
  • 协议:WebSocket(基于 HTTP 升级);编码:SBE 二进制
  • 连接有效期 24 小时
  • 认证:需要 API Key,仅支持 Ed25519;打开连接时放在 X-MBX-APIKEY 请求头,不需要 timestamp 和签名,也不需要额外权限
  • 所有时间字段的单位都是微秒

与 JSON 版本的区别:

特性 JSON 编码 SBE 编码
端点 stream.binance.com stream-sbe.binance.com
数据格式 JSON 文本 SBE 二进制
API Key 不需要 需要(Ed25519)
时间单位 默认毫秒 微秒
解析速度 较慢 快
实现复杂度 低 高(需要 SBE 解码器)
调试难度 易 难

支持的数据流:

  • 实时成交(@trade)
  • 最优买卖价(@bestBidAsk),支持自动剔除过时事件
  • 增量深度(@depth):50 ms 更新
  • 部分深度快照(@depth20):50 ms 更新

使用方式:订阅请求用 JSON 文本帧发送,市场数据以 SBE 二进制帧推送。

适用场景:对性能有极致要求的专业应用、需要减少网络带宽的场景、机构级行情系统、高频交易的行情部分。

2.4 用户数据流

推送内容:账户更新(余额变动)、订单更新(订单状态变化)、交易执行报告。

使用方式:在 WebSocket API 连接上订阅。

  • 已用 session.logon 登录的会话:发送 userDataStream.subscribe
  • 未登录:发送 userDataStream.subscribe.signature(带签名)
  • 订阅后,事件直接推送到这条 WebSocket API 连接上

Binance 在 2025-04-07 公告后,已从官方文档中删除了"用 REST 创建 listenKey、再连接 wss://stream.binance.com 接收用户数据"的方式,并说明 WebSocket API 订阅的延迟更低。新系统不要再用 listenKey。

2.5 适用场景

最适合:实时行情监控、交易机器人、量化交易策略、行情展示应用、移动端和 Web 应用。

优势:

  • WebSocket API 可在一条长连接上完成下单、查询和用户数据推送
  • Streams 实现简单,JSON 易于解析,支持广泛

劣势:

  • 极致性能场景仍不如 FIX SBE
  • JSON 有解析开销

三、REST API 接口

开发工具:requests(Python)、axios(JavaScript)、OkHttp(Java)。

关键步骤:

  • 实现 API Key 认证与请求签名
  • 处理 timestamp 同步
  • 实现频率限制控制
  • 处理错误和重试

3.1 基本信息

官方提供的入口(按需选用):

  • https://api.binance.com:CloudFront CDN 全球分发(CNAME d3h36i1mno13q3.cloudfront.net)
  • https://api-gcp.binance.com:部署在 Google Cloud
  • https://api1.binance.com – https://api4.binance.com:官方说明"性能更好、稳定性稍差";在东京解析为直连 EC2,每个域名 2 个 IP

对延迟敏感的用户应从东京直连 api1–api4,而不是走 CloudFront 的 api.binance.com。

协议:HTTPS;编码:默认 JSON,请求头加 Accept: application/sbe 和 X-MBX-SBE: <ID>:<VERSION> 可改为 SBE 响应;模式:请求-响应。

3.2 主要功能

账户管理:账户信息查询、资产余额查询、交易历史查询、存取款记录。

订单操作:

  • 下单(POST /api/v3/order)
  • 撤单(DELETE /api/v3/order)
  • 撤单并重新下单(POST /api/v3/order/cancelReplace)
  • 保留优先级改单(PUT /api/v3/order/amend/keepPriority,只能减少数量)
  • 查询订单(GET /api/v3/order)
  • 查询所有订单(GET /api/v3/allOrders)
  • 当前挂单(GET /api/v3/openOrders)
  • 批量撤单(DELETE /api/v3/openOrders)

市场数据:

  • 交易对信息(GET /api/v3/exchangeInfo)
  • 深度信息(GET /api/v3/depth)
  • 最近成交(GET /api/v3/trades)
  • K 线数据(GET /api/v3/klines)
  • 24 小时价格变动(GET /api/v3/ticker/24hr)

3.3 认证机制

API Key 认证:

  • 在请求头添加 X-MBX-APIKEY
  • 敏感操作需要签名

签名算法:

  • 支持 HMAC SHA256、RSA、Ed25519,官方推荐 Ed25519
  • 签名覆盖 timestamp 与请求参数,签名值放在请求参数中

3.4 频率限制

权重系统:

  • 每个接口有不同权重,按分钟和秒级别限制
  • 超限返回 429,持续超限会被封禁 IP(418)

限制类型:

  • REQUEST_WEIGHT:请求权重限制(按 IP 累计)
  • ORDERS:订单数量限制
  • RAW_REQUESTS:原始请求数限制

3.5 适用场景

最适合:普通交易应用、账户管理、历史数据查询、移动端和 Web 应用、不需要极致性能的场景。

优势:实现简单、标准 HTTP 协议、易于调试、支持广泛、文档完善。

劣势:每次请求都有完整的 HTTP 开销、不适合高频交易、有频率限制。

接口关系澄清

SBE 与各接口的关系

SBE 不是独立的接口,而是一种编码格式,Binance 在多个接口上都提供:

FIX API
  ├─ FIX 文本编码 (端口 9000)
  └─ FIX SBE 编码 (端口 9001 / 9002)
REST API / WebSocket API
  └─ 响应可选 SBE (Accept 头 / responseFormat 参数)
WebSocket Streams
  └─ SBE 行情流 (stream-sbe.binance.com)

WebSocket API 与 WebSocket Streams 的区别

特性 WebSocket API WebSocket Streams
交互方式 请求-响应(用 id 匹配) 订阅后服务端推送
能否下单 能 不能
认证 交易和账户请求需要签名或会话登录 公开行情不需要(SBE 流需要 Ed25519 API Key)
端点 ws-api.binance.com stream.binance.com、stream-sbe.binance.com

FIX Market Data 与 WebSocket Streams 的区别

这是两个完全独立的市场数据接口:

特性 FIX Market Data WebSocket Streams
协议 FIX(TCP + TLS) WebSocket(HTTP 升级)
端口 9000 / 9001 / 9002 9443 / 443
编码 FIX 文本或 FIX SBE JSON 或 SBE
目标用户 机构 / HFT 所有用户
性能 极致 良好
复杂度 高 低

选择建议:机构级 HFT 行情用 FIX Market Data(SBE 编码),高性能推送用 SBE 行情流,普通需求用 JSON 行情流。

参考资料

Next Post Previous Post
No Comment
Add Comment
comment url