latestOpenAPI 3.1.02026-08-1013317298.0 KB
d94e0e0f1821
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