Unlocks

Buy an entity's address

CHARGES THE BALANCE the entity's band price (0 = free) and returns its address. Send the handle and maxPriceCents, the price shown (higher now: 409 price_changed, nothing charged). Paid unlocks are permanent. viaPlan uses the plan allowance instead. Spends 1 daily distinct-entity unit.

post/v1/account/reveals

Request

  • Base URL: https://api.pmwallets.com
  • URL: https://api.pmwallets.com/v1/account/reveals
  • Auth: API key in header x-api-key

Request body

entityIdstring required

The 12-character handle from the board. A raw address is refused (400) unless you already own it.

maxPriceCentsinteger required

Ceiling in cents: the price you were shown. 0 is a real cap (free band).

viaPlanboolean

Unlock from the active plan allowance instead of buying.

Response

Unlocked, or already owned (alreadyOwned: true, nothing charged). HTTP 201. A free unlock lasts only while the wallet stays in the free band.

entityIdstring

The full 0x address.

labelstring
priceCentsinteger

Charged now (0 when free, from the plan, or already owned).

alreadyOwnedboolean

You already had it; nothing was charged.

viaPlanboolean

Changes

No recorded changes to this operation across all 1 revision of this API.