Trades

Manage and view trading activity

List marketplace trades

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v1/trades

Retrieves a list of trades in the marketplace. Trades represent peer-to-peer exchanges between users, including offers and accepted deals.

Results are ordered by creation date (most recent first).

Note: This endpoint currently returns all trades without pagination support.

Responses

200

List of trades

application/json

idstringRequired

Trade ID

buyerstringRequired

Buyer address

sellerstringRequired

Seller address

pricenumberRequired

Trade price

statusstring · enumRequired

Trade status

Possible values:

createdAtstring · date-timeOptional

Trade creation timestamp

get/v1/trades

HTTPcURLJavaScriptPython

GET /v1/trades HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

200

List of trades

[
  {
    "id": "text",
    "buyer": "text",
    "seller": "text",
    "item": {
      "id": "text",
      "name": "text",
      "description": "text",
      "image": "text",
      "category": "text",
      "rarity": "text",
      "price": 1,
      "owner": "text"
    },
    "price": 1,
    "status": "pending",
    "createdAt": "2026-08-11T10:47:42.318Z"
  }
]

Create a new trade

post

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v1/trades

Creates a new trade offer in the marketplace.

Authentication Required: This endpoint requires Decentraland authentication with signed metadata. The authentication validates:

• User identity via signed message (ADR-44l)

• Authorized origins (dcl:marketplace or dcl:builder)

• Metadata intent (dcl:create-trade)

The trade will be validated against blockchain data and marketplace rules before creation.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Body

application/json

itemIdstringRequired

Item ID

pricenumberRequired

Trade price

sellerstringRequired

Seller address

Responses

201

Trade created successfully

application/json

idstringRequired

Trade ID

buyerstringRequired

Buyer address

sellerstringRequired

Seller address

pricenumberRequired

Trade price

statusstring · enumRequired

Trade status

Possible values:

createdAtstring · date-timeOptional

Trade creation timestamp

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

post/v1/trades

HTTPcURLJavaScriptPython

POST /v1/trades HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "itemId": "text",
  "price": 1,
  "seller": "text"
}

{
  "id": "text",
  "buyer": "text",
  "seller": "text",
  "item": {
    "id": "text",
    "name": "text",
    "description": "text",
    "image": "text",
    "category": "text",
    "rarity": "text",
    "price": 1,
    "owner": "text"
  },
  "price": 1,
  "status": "pending",
  "createdAt": "2026-08-11T10:47:42.318Z"
}

Get trade by ID

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v1/trades/{id}

Retrieves detailed information about a specific trade including:

• Trade participants (buyer and seller)

• Item details and metadata

• Trade price and currency

• Current status (pending, completed, or cancelled)

• Timestamps (creation, updates, completion)

Path parameters

idstringRequired

Unique trade identifier

Responses

200

Trade details

application/json

idstringRequired

Trade ID

buyerstringRequired

Buyer address

sellerstringRequired

Seller address

pricenumberRequired

Trade price

statusstring · enumRequired

Trade status

Possible values:

createdAtstring · date-timeOptional

Trade creation timestamp

404

Trade not found

application/json

get/v1/trades/{id}

HTTPcURLJavaScriptPython

GET /v1/trades/{id} HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

{
  "id": "text",
  "buyer": "text",
  "seller": "text",
  "item": {
    "id": "text",
    "name": "text",
    "description": "text",
    "image": "text",
    "category": "text",
    "rarity": "text",
    "price": 1,
    "owner": "text"
  },
  "price": 1,
  "status": "pending",
  "createdAt": "2026-08-11T10:47:42.318Z"
}

Get trade acceptance event

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v1/trades/{hashedSignature}/accept

Retrieves information about a trade acceptance event using the hashed signature. This endpoint is used to verify and track when a trade offer was accepted on-chain.

The hashed signature serves as a unique identifier linking the off-chain trade to its blockchain transaction acceptance event.

Path parameters

hashedSignaturestringRequired

Keccak-256 hashed signature of the trade acceptance transaction

Responses

200

Trade accepted event

application/json

tradeIdstringRequired

Trade ID

hashedSignaturestringRequired

Hashed signature

timestampstring · date-timeOptional

Event timestamp

404

Event not found

application/json

get/v1/trades/{hashedSignature}/accept

HTTPcURLJavaScriptPython

GET /v1/trades/{hashedSignature}/accept HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

{
  "tradeId": "text",
  "hashedSignature": "text",
  "timestamp": "2026-08-11T10:47:42.318Z"
}