ApiMarketplace orders
Reserve at the provider + return the invoice (minted on the provider domain wallet). First-party rows claim free + instantly. Returns { requote } instead when the price drifted >5% from the search quote.
POST
bearerX-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"application/json- body
providerId*stringAddressProvider id
domainCatalogId*stringMarketplaceDomain catalog row id
localPart*stringyears?numberexpectedPriceSats?numberSats quote shown at search time — re-quote guard (§2.2): reservation drift >5% requires re-confirmation
acceptRequote?booleanSet true to accept the re-quoted price after a drift warning
pubkey?stringNostr pubkey (hex) for the address; defaults to the wallet pubkey
promoCode?stringPromo code (provider-side)
curl -X POST 'http://localhost:3001/api/v1/marketplace/orders' \ -H 'Content-Type: application/json' \ -d '{ "providerId": "string", "domainCatalogId": "string", "localPart": "alice"}'Example Response201
Empty