PMWallets
EN
榜单

单个实体详情

数据、标签、盈亏曲线、钱包和近期成交。订阅者(有生效的推送或套餐)可以打开任意实体,占用 1 次每日不同实体额度;其他人只能打开免费样本或付费解锁过的实体。用未持有的完整地址请求返回 403 not_unlocked,并带代号和价格。绝不扣费。

GET/v1/entities/{id}API key

路径参数

idstring必填

12 位实体代号(Crockford base32,如 7KQ2MF9X4B1C)或完整 0x 地址(40 位十六进制)。

查询参数

periodstring

窗口 ID(30d 或 7d)。默认 30d。

返回字段

periodIdstring
entityIdstring

代号;如果你持有该地址,则是地址。

labelstring
tierstring

可选值: freesubscriber

revealedboolean
revealCentsinteger

当前解锁价(0 = 免费档)。

viaPlanboolean
planPlanUsage

当前账户的套餐和剩余解锁额度(登录后返回)。

subscribedboolean
badgesstring[]
tagVersioninteger
categoriesobject[]
statsobject

窗口数据(字段与榜单行相同,另有 wr/lo/hi)。

historyobject | null

若较多市场的持仓早于账本起点,则返回此字段。

dataSourcestring

可选值: livefrozen

dataPeriodIdstring
dataAsOfstring | null
statusstring

可选值: activequietdormant

statusAsOfstring | null
pnlCurveobject

从创世起累计到每日结束时的盈亏。

walletsobject[]
fillsEntityFill[]
tagsobject
fillSampleinteger

fills 的行数上限(订阅者 100,否则 10)。

fillsDelayedMsinteger

订阅者为 0,否则为 900000(15 分钟)。

viewsobject

订阅者:本次调用后剩余的不同实体额度。

状态码

200成功
400不是代号或 0x 地址、代号不存在,或窗口不存在。
401没有有效的 API key(缺失、格式错误、不存在或已删除)。
403error: not_unlocked(你未持有的地址;响应体包含 entityId = 代号、label、revealCents),或达到每日不同实体上限,或不在免费样本内(需要订阅或付费解锁)。
404这个窗口内没有该实体的已发布统计。
429超出频率限制。按 IP 总计 240 次/分钟,榜单和实体接口 180 次/分钟;榜单、实体和市场读取按账户 120 次/分钟(匿名按 IP 60 次/分钟)。可能带 retry-after 响应头。
503暂时不可用,没有扣费。请稍后重试。