GetOrderbookOrders

With the use of the GetOrderbookOrders api developers can build custom marketplaces around the api, as an example, one can implement a frontend to fulfill certain orders (not just the best price) for a collectible

​

Example

GetOrderbookOrders of token ids from a collection address on Sepolia:

curl --request POST \

  --url https://marketplace-api.sequence.app/arbitrum-sepolia/rpc/Marketplace/GetOrderbookOrders \

  --header 'Content-Type: application/json' \

  --data '{

    "collectionAddress": "0x1693ffc74edbb50d6138517fe5cd64fd1c917709",

    "currencyAddresses": [

        "0xa9c88358862211870db6f18bc9b3f6e4f8b3eae7"

    ],

    "filters": {

        "isListing": true,

        "tokenIds": [

            "0",

            "1",

            "4",

            "5"

        ]

    },

    "orderStatuses": [

        "OPEN","CANCELLED"

    ],

    "page": {

        "sort": [

            {

                "column": "createdAt",

                "order": "ASC"

            }

        ]

    },

    "orderbookContractAddress": "0xB537a160472183f2150d42EB1c3DD6684A55f74c"

}'

​

Schema

Query the protocol for orders based on various filters.

Sequence Orderbook GetOrderbookOrders Method:

• Request: POST /rpc/Marketplace/GetOrderbookOrders
• 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
  • filters (OrderbookOrderFilter) — filters to apply to the query
    • tokenIds (string[]) — the token ids of the assets you’re looking at
    • isListing? (bool) — true if it is an order, false if it’s an offer
    • userAddress? (string) — the address of the user
  • orderStatuses (OrderStatus[]) (optional) — filter orders by their statuses as OPEN, CLOSED, CANCELLED strings
  • metadataFilter (Filter) (optional) — filter orders by metadata
    • text? (string) — text to search
    • properties? (PropertyFilter[]) —
      • name (string) — name of the property, eg: hero
      • type: (PropertyType) — type of the values of the property as an enum from: "INT","STRING","ARRAY", or "GENERIC"
      • min?: (int64) — used if type is int, gives range of values for filtering
      • max?: (int64) — used if type is int, gives range of values for filtering
      • values?: []any — if string then array of values, eg: [“Ada”, “Ari”, “Axel”, “Banjo” …]
  • beforeExpiryTimestamp (int64) — filter orders expiring before the given timestamp
  • page? — page object to sort by
    • sort (Sort[]) — with an object of keys "column" and "order" with example "createdAt" and "ASC", respectively
• 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 ]