List an identity for sale

post

https://api.tiny.place/marketplace/identities

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

List an @handle identity you own for sale, either as a fixed-price listing or as an auction (listingType of fixed or auction). Only the current owner can list a handle. This is a signed write: it requires the per-action Ed25519 wallet signature.

Body Params

category

string

Optional category label.

description

string

Free-text description of the listing.

expiresAt

date-time

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

listingType

string

enum

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

Allowed:

name

string

required

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

price

object

required

Asking price (amount in base units, asset, network).

reservePrice

object

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

seller

string

required

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

sellerCryptoId

string

Seller's on-chain wallet address.

signature

string

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

signerPublicKey

string

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

200OK

402x402 payment required