Is the hosted Reservoir API free to use?

Currently, the hosted Reservoir API is free to use. The hosted API is designed to have as few limits as possible, while also putting basic protections in place to prevent abuse. While there are no rate-limits, we ask that you use a API key which you can get here. To learn more see the docs about API Keys & Rate Limits.

From where does Reservoir currently aggregate orders?

Currently, Reservoir aggregates sell-side orders (asks) from:

  • OpenSea
  • LooksRare
  • X2Y2
  • Foundation
  • Reservoir’s native applications

We currently only aggregate buy-side orders (bids) from Reservoir's native applications. We are in the process of adding more liquidity sources, but if there is a particular place you think we should prioritize, please reach out.

Are there any plans to expand to sidechains/L2s such as Polygon?

Yes. We plan to expand to other chains in the future. However, right now we are super focused on Ethereum, because that's where the most value is, and strongest need for a decentralized order book.

Where do Reservoir native orders get distributed to?

Reservoir orders get distributed to any application that natively ingests orders from the aggregated orderbook. While Reservoir native orders are not atomically pushed to OpenSea, we make it possible (and easy) to publish orders into the OpenSea orderbook using our Router contract or API. For more details the API reference here.

How do marketplace and royalty fees work with Reservoir?

With our easy-to-use APIs apps built on Reservoir have full control over marketplace and royalty fees.

What is a trait-specific bid?

Trait-specific bids are bids that apply to any token that has a particular trait associated with it. A single trait-specific bid can be accepted by any holder of a token with the trait. Once your single trait-specific bid is accepted, is it considered executed, so only one sale is possible with each bid quantity, even if the bid applies to multiple tokens. Further, we allow you to create custom sets of tokens on which to bid, in a similar style to how trait-specific bids work (see the API reference here) as well as create your own custom metadata for collections ( see Metadata Engine).

How do I get a Reservoir API key?

Register for an API key here. If you want to just test out the API first, feel free to query without the key.

What is WETH?

Wrappeed Ethereum (WETH) is Ethereum wrapped in the ERC-20 standard. This ERC-20 standard allows you to approve the token to be transferred, which is the fundamental mechanism by which you can place bids and have the WETH transferred out of your wallet at a later date. This is also why you need to approve your WETH for trading.

Why is it necessary to pay gas to cancel orders?

You need to pay to cancel orders because orders are signed atomic units that can be copied. If Reservoir simply deleted your order from the orderbook, there's no way to know whether someone has a signed copy of the order stored elsewhere. When you cancel an order, you are sending a transaction to the on-chain exchange contract tell it to not process your order. Since this step must be done on-chain, you need to pay gas.

Where is the Reservoir router contract?

The ethereum contract address for the Reservoir router is: 0xc52b521b284792498c1036d4c2ed4b73387b3859 (etherscan)

Did this page help you?