Marketplace

Create a marketplace listing (multi-chain settlement)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/marketplace/listings

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

projectIdstring | nullableOptional

assetTypestring · enumRequiredPossible values:

sellerWalletIdstringRequired

settlementChainKeystringRequiredExample: ton-mainnet

paymentCurrencyCodestringRequiredExample: GOLD

paymentAmountstringRequiredExample: 5.00

escrowModestring · enumOptionalDefault: nonePossible values:

idempotencyKeystring | nullableOptional

Responses

201

Listing created

application/json

post

/v1/marketplace/listings

HTTPcURLJavaScriptPython

POST /v1/marketplace/listings HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 243

{
  "projectId": "text",
  "assetType": "nft",
  "assetRef": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "sellerWalletId": "text",
  "settlementChainKey": "ton-mainnet",
  "paymentCurrencyCode": "GOLD",
  "paymentAmount": "5.00",
  "escrowMode": "none",
  "idempotencyKey": "text"
}

201

Listing created

{
  "id": "lst_01HXYZ...",
  "projectId": "text",
  "status": "active",
  "assetType": "nft",
  "assetRef": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "sellerWalletId": "text",
  "settlementChainKey": "eth-mainnet",
  "paymentCurrencyCode": "GOLD",
  "paymentAmount": "5.00",
  "escrowMode": "none",
  "createdAt": "2026-01-19T11:19:09.886Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Create an order (purchase a listing)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/marketplace/orders

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

listingIdstringRequired

buyerWalletIdstringRequired

idempotencyKeystring | nullableOptional

Responses

201

Order created

application/json

post

/v1/marketplace/orders

HTTPcURLJavaScriptPython

POST /v1/marketplace/orders HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "listingId": "text",
  "buyerWalletId": "text",
  "idempotencyKey": "text"
}

201

Order created

{
  "id": "ord_01HXYZ...",
  "listingId": "text",
  "buyerWalletId": "text",
  "status": "pending",
  "createdAt": "2026-01-19T11:19:09.886Z",
  "settlementChainKey": "text",
  "transactionId": "text",
  "receipt": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}