Accessing Native Reservoir Liquidity

Reservoir's aggregated order book consists of two categories of orders:

  1. Mirrored: from external marketplaces (OpenSea, LooksRare, X2Y2, etc)
  2. Native: from marketplaces built directly on top of Reservoir

There are now over 100 marketplaces creating native liquidity through Reservoir, including:

  • ENSVision (Major ENS Marketplace doing ~50% of all ENS sales)
  • Truth Marketplace (Official Marketplace for Goblintown.wtf, IlluminatiNFT, etc)
  • Forgotten.Market (Forgotten Runes Wizard Cult Community Marketplace)

Aggregators looking to ingest only native Reservoir liquidity (because they already have the rest), can do so easily by querying the Asks API with the filter native=true

https://api.reservoir.tools/orders/asks/v3?native=true&includePrivate=false&includeMetadata=false&includeRawData=true&sortBy=createdAt&limit=1000

This API is designed to be queried in bulk, returning up to 1000 orders at a time. To get all orders, follow the continuation until you see a result you've ingested already. To get real-time orders, poll every second for new results.

Supported Protocols

The Reservoir Order Book supports the following order kinds:

  • seaport
  • zeroex-v4-erc721
  • zeroex-v4-erc1155
  • wyvern-v2.3 (deprecated)

The vast majority of current orders (99.99%) use seaport.

You can filter out protocols you don't support by looking at the kind field in the response.

Marketplace Metadata

Every order contains detailed source information, to help you correctly attribute the marketplace where the order came from.

"source": {
        "domain": "ens.vision",
        "name": "ENSVision",
        "icon": "https://www.ens.vision/favicon.ico"
      },

Did this page help you?