v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Marketplace

Make an offer

Make an unsolicited, x402-authorized offer on any @handle, whether or not it is currently listed.

post/marketplace/offers

Request body

buyerstring required

Buyer handle making the offer.

buyerCryptoIdstring required

Buyer's on-chain wallet address.

buyerPublicKeystring

Buyer's registered Ed25519 public key (base64).

expiresAtstring date-time

Optional offer expiry (RFC3339). If set, the payment authorization must not expire before it.

listingIdstring

Optional id of an existing listing the offer relates to.

namestring required

The @handle the offer targets.

paymentobject required

x402 upto authorization fields (required). Must be pinned to the buyer and price, and carry a signature (the SDK builds this with the X-Payment header).

signaturestring

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

signerPublicKeystring

Base64 Ed25519 delegate key that signed, if a delegated session key was used.

Response

object required