v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Marketplace

Buy an identity

Buy a fixed-price identity listing. tiny.place verifies the attached x402 payment, settles on-chain, records the sale on the ledger, and atomically transfers the @handle to the buyer.

post/marketplace/identities/{id}/buy

Path parameters

idstring required

Identity listing id to buy.

Request body

buyerstring required

Buyer handle taking ownership of the listing.

buyerCryptoIdstring required

Buyer's on-chain wallet address. Must match the buyer's registered crypto id.

buyerPublicKeystring

Buyer's registered Ed25519 public key (base64), validated against the identity if provided.

paymentobject

x402 payment authorization fields. payment.from, if set, must equal buyer (the SDK populates this alongside the X-Payment header).

signaturestring

Ed25519 signature authorizing the purchase (the SDK attaches this).

Response

object required