解锁地址

地址的价格,以及解锁后能看多久。

拿到地址的三种方式

单独买。永久归你,不需要套餐。
免费档。扣掉最赚的一个市场后没赚到钱的钱包不收费,只在它仍属于免费档时有效。
套餐解锁。每个套餐每天、每期可解锁一定数量的地址,在套餐有效期及适用的 48 小时宽限期内可见。见套餐与计费。

买下一个地址

POST/v1/account/revealsAPI key

解锁价格分 6 档,按 pnlExTop 计算,即已实现盈亏扣掉它最赚的那一个市场之后剩余的盈亏。靠一个市场盈利和在多个市场盈利五十次的钱包,价格不同。band 0 是免费:扣掉最赚的一个市场后没有盈利,就不收费。每行的 revealCents 就是它的价格,pricing.bands 给出完整的档位表。

shell

# buy the address behind a handle. maxPriceCents is REQUIRED and is a
# ceiling: it is the price you were shown, and the charge can never exceed it.
curl -X POST https://api.pmwallets.com/v1/account/reveals \
  -H "Authorization: Bearer $PMW_KEY" -H "content-type: application/json" \
  -d '{"entityId":"7KQ2MF9X4B1C","maxPriceCents":150}'

# what you already own, newest purchase first
curl -s https://api.pmwallets.com/v1/account/reveals -H "Authorization: Bearer $PMW_KEY"

json

// POST /v1/account/reveals  →  201
{
  "entityId": "0x4b96e2d59f0dabde95ae6f55f2d2d6d345ba984e",   // yours now
  "label": "0x4b96e2d59f0dabde95ae6f55f2d2d6d345ba984e",
  "priceCents": 150,
  "alreadyOwned": false            // true = you had it; nothing was charged
}

// 409 — the band moved between the page and the click. Nothing was charged.
{ "statusCode": 409, "error": "price_changed", "priceCents": 200, "agreedCents": 150 }

// 402 — not enough balance. Nothing was charged.
{ "statusCode": 402, "error": "insufficient_balance", "priceCents": 150, "balanceCents": 120 }

// GET /v1/account/reveals  →  200
[
  { "entityId": "0x4b96…984e", "label": "0x4b96…984e", "priceCents": 150, "entitled": true,
    "createdAt": "2026-09-20T10:23:00.000Z", "paidAt": "2026-09-20T10:23:00.000Z" },
  // a FREE unlock whose wallet has since moved into a paid band: the address is masked again
  { "entityId": "9XQ4MF7K2B1C", "label": "0x8a1f…22ce", "priceCents": 0, "entitled": false,
    "revealCents": 200, "createdAt": "2026-09-18T08:00:00.000Z", "paidAt": null }
]

entityId	handle	填榜单给出的 12 位 handle。直接传地址返回 400,已购买的地址除外。这能防止批量查地址是否上榜,泄露待售信息。
maxPriceCents	int ≥ 0	必填,填你看到的价格,作为扣款上限。档位随每天发布的 30d 榜单更新。现价超过上限时返回 409 和新价,不扣费。0 表示只接受免费档,也算设置了上限。

付费解锁永久有效。以后再看不收费,订阅到期也不影响。 ⚠ 免费解锁只在钱包仍属免费档时有效:如果钱包之后进入收费档,再次查看需按新档付费 (点「免费查看」时就写明了)。GET /v1/account/reveals 里, 这类记录会重新显示为 handle,并带上 entitled: false 和新的价格。

每个账户每天可查询的不同实体数有上限(超出返回 403,UTC 0 点重置),用于限制批量查询整张榜单。已购买的实体再次查询不计入额度。解锁、订阅、购买导出(每个实体一次)共用这份额度,同一天重复查询同一实体不重复扣。

← 榜单订阅实体 →