Orders

Manage marketplace orders

List marketplace orders

get

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

/v1/orders

Retrieves marketplace orders (listings) for NFTs and items. Orders represent sell listings created by item owners.

Filter options:

• Contract address, token ID, and item ID

• Order status (open, sold, cancelled)

• Owner (seller) or buyer addresses

• Marketplace address

• NFT name search

• Network (Ethereum, Polygon)

Sorting options:

• recently_listed, recently_updated, cheapest

• issued_id_asc, issued_id_desc, oldest

Pagination: Uses first and skip parameters (NOT limit/offset).

Use this endpoint to find available items for purchase and their pricing.

Query parameters

firstnumberOptional

Maximum number of orders to return (default: 100)

Default: 100Example: 10

skipnumberOptional

Number of orders to skip for pagination (default: 0)

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: recently_listedPossible values:

marketplaceAddressstringOptional

Filter by marketplace contract address

ownerstringOptional

Filter by owner (seller) wallet address

Example: 0x1234567890abcdef1234567890abcdef12345678

buyerstringOptional

Filter by buyer wallet address

contractAddressstringOptional

Filter by NFT contract address

Example: 0x1234567890abcdef1234567890abcdef12345678

tokenIdstringOptional

Filter by specific token ID

statusstring · enumOptional

Filter by order status

Example: openPossible values:

networkstring · enumOptional

Filter by blockchain network

Example: MATICPossible values:

itemIdstringOptional

Filter by item ID

nftNamestringOptional

Filter by NFT name

Responses

200

List of orders with total count

application/json

totalnumberRequired

Total number of orders matching the filters

400

Bad request - invalid parameters

application/json

get

/v1/orders

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "id": "text",
      "maker": "text",
      "taker": "text",
      "item": {
        "id": "text",
        "name": "text",
        "description": "text",
        "image": "text",
        "category": "text",
        "rarity": "text",
        "price": 1,
        "owner": "text"
      },
      "price": 1,
      "status": "open",
      "createdAt": "2026-05-16T03:28:27.149Z"
    }
  ],
  "total": 1
}