PMWallets
EN
解锁地址

购买实体地址

按实体档位从余额扣费(0 = 免费)并返回地址。传代号和 maxPriceCents(你看到的价格;现价更高时返回 409 price_changed,不扣费)。付费解锁永久有效。viaPlan 改用套餐额度。占用 1 次每日不同实体额度。

POST/v1/account/revealsAPI key会扣余额

请求体

entityIdstring必填

榜单给出的 12 位代号。直接传完整地址返回 400,已持有的地址除外。

maxPriceCentsinteger必填

价格上限(美分):你看到的价格。0 是有效上限(免费档)。

取值范围: 0 <= x

viaPlanboolean

使用当前套餐额度解锁,无需单独购买。

返回字段

entityIdstring

完整 0x 地址。

labelstring
priceCentsinteger

本次扣费(免费、使用套餐或已持有时为 0)。

alreadyOwnedboolean

你已经持有,没有扣费。

viaPlanboolean

状态码

201已解锁,或你已持有(alreadyOwned: true,不扣费)。HTTP 201。免费解锁只在钱包仍属于免费档时有效。
400maxPriceCents 缺失或无效、代号不存在,或传了你未持有的完整地址。
401没有有效的 API key(缺失、格式错误、不存在或已删除)。
402error: insufficient_balance,带 priceCents 和 balanceCents;不扣费。
403已达到每日不同实体上限。
404实体不在任何已发布窗口里。
409error: price_changed(priceCents、agreedCents)或 error: plan_exhausted(limit、priceCents)。不扣费。
503暂时不可用,没有扣费。请稍后重试。