Sign in
Orders

List marketplace 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.

get/v1/orders

Query parameters

firstnumber

Maximum number of orders to return (default: 100)

skipnumber

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

sortBy'recently_listed' | 'recently_updated' | 'cheapest' | 'issued_id_asc' | 'issued_id_desc' | 'oldest'

Sort results by specified criteria

marketplaceAddressstring

Filter by marketplace contract address

ownerstring

Filter by owner (seller) wallet address

buyerstring

Filter by buyer wallet address

contractAddressstring

Filter by NFT contract address

tokenIdstring

Filter by specific token ID

status'open' | 'sold' | 'cancelled'

Filter by order status

network'ETHEREUM' | 'MATIC'

Filter by blockchain network

itemIdstring

Filter by item ID

nftNamestring

Filter by NFT name

Response

List of orders with total count

totalnumber required

Total number of orders matching the filters

Changes

No recorded changes to this endpoint across all 1 revision of this API.