PMWallets
EN
WebSocket

成交实时流

推送你账户订阅的所有实体的成交,你发过来的内容会被忽略。尽力投递,帧不重发:seq 跳号或 session 变了就是漏了帧,用 GET /v1/account/fills 补回。每个账户一条 API 连接。服务端每 15 秒 ping 一次。

WSSwss://api.pmwallets.com/v1/wsAPI key

请求头参数

x-api-keystring必填

你的 API key。

查询参数

clientIdstring

8 到 64 位 A-Za-z0-9_-。每个运行中的客户端一个,重连时保持不变,这样重连会直接替换自己断掉的连接。

takeoverstring

设为 1 时替换已连接的 API 客户端。

可选值: 1

消息字段

typestring必填

连接时收到 hello,之后是 fill;连接被拒时是 blocked。

dataobject

成交内容,字段见成交事件页。

sessionstring

重连后会变。

seqinteger

同一 session 内连续递增。

reasonstring

仅 blocked:被拒原因,如 api_seat_taken。

状态码和关闭码

1000被 takeover 替换。停止,不要重连。
1012服务重启中。立即重连,然后补拉漏掉的成交。
1013连接数已满,稍后再试。
4409网页连接被拒:API 客户端正在占用这条流。
4410网页连接被 API 客户端替换。
4411已有其他 API 客户端在连接。带 takeover=1 重连可以替换它。