实时成交推送
订阅实体(实时成交)
通过 WebSocket 或 Webhook 发出实体的成交。需要先解锁地址(否则 402 address_not_unlocked)。立即扣 1 美分支付第一小时,之后每小时扣费直到取消(套餐推送名额内免费)。占用 1 次每日不同实体额度。从链头前约 96 秒(65 个块)开始。
POST/v1/account/subscriptionsAPI key会扣余额
请求体
entityIdstring必填
12 位实体代号(Crockford base32,如 7KQ2MF9X4B1C)或完整 0x 地址(40 位十六进制)。
channelsstring[]默认:ws
推送通道。默认 ["ws"]。
acceptInactiveboolean
即使实体 7 天没有成交也订阅(否则 409)。
返回字段
idstring
userIdstring
chaininteger
entityIdstring
付费买下且仍持有时是 0x 地址;否则是代号(未付费或套餐权限已失效的记录)。
labelstring
channelsstring[]
statusstring
可选值: activepausedcanceled
pausedReasonstring | null
如 insufficient_balance、webhook_disabled、no_webhook、plan_ended、plan_limit、address_locked。
fromBlockinteger
发出此区块之后的成交。
syncedBlockinteger
tierstring
priceCentsinteger
订阅时锁定的每小时价格。
billedThroughstring | null
已付费的截止时间。
planCoveredboolean
最近一个计费小时由套餐推送名额覆盖(免费)。
activationsinteger
createdAtstring
canceledAtstring | null
followedAtstring | null
categoriesobject[]
只有列表接口返回。
lastFillTsstring | null
只有列表接口返回。
fills24hinteger | null
只有列表接口返回。
状态码
201订阅成功,第一小时已付(HTTP 201)。没有推送的小时不收费;余额用完时暂停。最多 200 个生效订阅。
400entityId 或 channels 无效,或已有 200 个生效订阅。
401没有有效的 API key(缺失、格式错误、不存在或已删除)。
402
error: address_not_unlocked(先解锁),或余额不足以支付第一小时(priceCentsPerHour、balanceCents)。不扣费。403已达到每日不同实体上限。
404实体不在任何已发布窗口里。
409实体已休眠(带 acceptInactive: true 重发)、已订阅、并发创建,或唯一通道是缺失或已停用的 Webhook。不扣费。
503成交数据或链头暂不可用,不扣费。