Skip to content


With the use of the GetTopOrders api developers can build bots to retrieve best orders to execute on, or, just simple notifiers to track the best orders to take action.

curl --request POST \
    --url \
    --header 'Content-Type: application/json' \
    --data '{
        "collectionAddress": "0x1693ffc74edbb50d6138517fe5cd64fd1c917709",
        "currencyAddresses": [
        "orderbookContractAddress": "0xB537a160472183f2150d42EB1c3DD6684A55f74c",
        "tokenIDs": ["0","1", "2", "3", "4", "5"],
        "isListing": true,
        "priceSort": "DESC"


Query the protocol for the top order based on various filters.

Fetch the top orders from the protocol, optionally excluding those created by a specific user.

  • Request: POST /rpc/Marketplace/GetTopOrders
  • Content-Type: application/json
  • Body (in JSON):
    • orderbookContractAddress (string) -- the address of the protocol contract
    • collectionAddress (string) -- the address of the NFT collection
    • currencyAddresses (string[]) -- an array of currency contract addresses
    • tokenIDs (string[]) -- an array of token IDs to filter the orders by
    • isListing (bool) -- whether to fetch listing orders (true) or offer orders (false)
    • priceSort (SortOrder) -- the direction to sort the orders by price as an enum of "DESC" or "ASC"
    • excludeUser? (string) -- the address of a user whose orders to exclude
  • Response (in JSON):
    • page
      • page (i32) -- number of the page
      • pageSize (i32) -- number of orders on the page
      • more (bool) -- if there are more orders
    • orders (OrderbookOrder[]) [
      • orderId (string) -- order id
      • tokenContract (string) -- the collection contract
      • tokenId (string) -- the tokenId of the collection in the order
      • isListing (bool) -- is true if it's a listing for sale, or false if it's an offer
      • quantity (string) -- the number of tokens the order is for
      • quantityRemaining (string) -- the number of tokens after the order
      • currencyAddress (string) -- the currency the token is trading in
      • pricePerToken (string) -- the price per token
      • expiry (string) -- the expiry of when the order is no longer valid
      • orderStatus (OrderStatus) -- the status of the order as an enum fom "OPEN", "CLOSED", "CANCELLED"
      • createdBy (string) -- the address the order was created by
      • createdAt (uint64) -- the time the order was created
      • orderbookContractAddress (string) -- the orderbook contract address ]