Marketplace
Cometh ConnectCometh MarketplaceCometh checkout
  • Demo
  • API reference doc
  • SDK reference doc
  • 🚀Quickstart
    • Getting started
    • Core concepts
    • API cheatsheet
    • Third party helpers
  • 🛠️Core features
    • Get collection data
    • Assets search engine
    • Creating an order
    • Searching orders
    • Filling an order
    • Cancelling an order
  • ⚗️Advanced features
    • Tracking indexing
    • Get asset transfers
    • Admin routes
    • Refreshing metadata
    • Webhooks
  • 📖Resources
    • Why Cometh Marketplace
    • Order flow
    • Preparing for transactions
    • Sponsoring transactions
Powered by GitBook
On this page
  1. Resources

Order flow

Last updated 8 months ago

An order can go through several statuses. It can never go back to a previous status. Both on-chain and off-chain orders go through the same statuses and they can be differentiated by the updatedAtBlockNumber field.

The main statuses, derived from the 0x protocol are the following:

  • open: order was just listed by the maker

  • filled: order was filled by a taker

  • cancelled: order was cancelled

We have also added three cancel statuses to improve the on-chain system:

  • cancelled_by_transfer: The owner of the order's asset lost ownership of the asset.

  • expired: The expiry date was reached, all orders are periodically checked and cancelled when this happens.

  • invalid: Some context on chain made the order invalid. For example, the user might have lost the required ERC20 or lower his allowances.

📖