---
title: "List marketplace orders"
method: GET
path: "/v1/orders"
tags: ["Orders"]
---

# List marketplace orders

`GET /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

- `first` number
- `skip` number
- `sortBy` 'recently_listed' | 'recently_updated' | 'cheapest' | 'issued_id_asc' | 'issued_id_desc' | 'oldest'
- `marketplaceAddress` string
- `owner` string
- `buyer` string
- `contractAddress` string
- `tokenId` string
- `status` 'open' | 'sold' | 'cancelled'
- `network` 'ETHEREUM' | 'MATIC'
- `itemId` string
- `nftName` string

## Response `200`

List of orders with total count

- object
  - `data` object[], required
    - `id` string, required — Order ID
    - `maker` string, required — Maker address
    - `taker` string — Taker address
    - `item` object
      - `id` string, required — Item ID
      - `name` string, required — Item name
      - `description` string — Item description
      - `image` string — Item image URL
      - `category` string, required — Item category
      - `rarity` string — Item rarity
      - `price` number — Item price
      - `owner` string — Item owner
    - `price` number, required — Order price
    - `status` 'open' | 'filled' | 'cancelled', required — Order status
    - `createdAt` string, date-time — Order creation timestamp
  - `total` number, required — Total number of orders matching the filters

## Other responses

- `400` — Bad request - invalid parameters

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)