Marketplace API

tip

Prices are in zatoshis (1 ZEC = 100,000,000 zat).

---

All Listings

Get all names currently listed for sale.

GET /v1/marketplace/listings

curl https://zns-server-production.up.railway.app/v1/marketplace/listings

Response 200 OK

{
  "listings": [
    {
      "name": "premium",
      "price_zat": 500000,
      "seller_address": "u1sell...addr",
      "list_txid": "e4f5a6b7...",
      "listed_at_height": 2920100
    }
  ]
}

---

Single Listing

Get listing details for a specific name.

GET /v1/marketplace/listing/{name}

curl https://zns-server-production.up.railway.app/v1/marketplace/listing/premium

Response 200 OK

{
  "name": "premium",
  "price_zat": 500000,
  "seller_address": "u1sell...addr",
  "list_txid": "e4f5a6b7...",
  "listed_at_height": 2920100
}

Field	Type	Description
name	string	Listed name
price_zat	number	Price in zatoshis
seller_address	string	Seller's payout address
list_txid	string	Transaction ID of the LIST operation
listed_at_height	number	Block height when listed

Errors: 404 No active listing for this name