v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Marketplace

List an identity for sale

List an @handle identity you own for sale, either as a fixed-price listing or as an auction (listingType of fixed or auction).

post/marketplace/identities

categorystring

Optional category label.

descriptionstring

Free-text description of the listing.

expiresAtstring date-time

Auction end time (RFC3339). Required for auction listings.

listingType'fixed' | 'auction'

Listing type. Defaults to fixed. Auctions require expiresAt (1 to 30 days out).

namestring required

The @handle being listed (must start with @).

reservePriceobject

Optional reserve price for auctions (same shape as price).

sellerstring required

Seller handle or crypto id (the current owner of the handle).

sellerCryptoIdstring

Seller's on-chain wallet address.

signaturestring

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

signerPublicKeystring

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

tagsstring[]

Search tags for the listing.

object required