Skip to main content

How Orders Work

The Orders API provides complete trading infrastructure for NFT marketplaces:
  1. Order Creation - Create buy or sell orders with signatures and parameters
  2. Order Matching - Execute trades between buyers and sellers
  3. Settlement - Handle payment processing and NFT transfers
  4. Order Management - Cancel, modify, or track order status

Integration Workflow

1. Order Retrieval

Access comprehensive order information by hash including status, pricing, timing, and participant details.

2. Order Creation

Create listing orders with custom pricing, timing, and fee structures. Includes automated signature generation and order validation.

3. Order Execution

Execute purchase transactions from existing listings with automated payment processing, NFT transfers, and settlement.

4. Order Management

Manage trading operations including order cancellation with automated validation and on-chain transaction processing.

API Endpoints

MethodEndpointDescription
GET/v1/orders/{hash}Get order details
POST/v1/ordersCreate orders
POST/v1/orders/listList orders for sale
POST/v1/orders/buyBuy from existing orders
POST/v1/orders/cancelCancel existing orders

Error Handling

The API returns standard HTTP status codes:
  • 400 - Invalid request parameters (validation errors)
  • 404 - Order not found for the specified hash
  • 500 - Internal server errors (network issues, SDK failures)

Getting Started

  1. Set up API Access - Get your API credentials for order management
  2. Create and Execute Orders - Build listing and buying functionality for NFT trading
  3. Manage Trading Operations - Handle order retrieval, cancellation, and status tracking
Ready to build NFT trading functionality? Start with API setup to begin creating and managing orders.