Currently, Reservoir aggregates sell-side orders (asks) from:
- Coinbase NFT
- Manifold Gallery
- Reservoir’s native applications
And buy-side orders from:
You can find a more detailed breakdown here.
Currently, Blur has a closed API. The moment Blur releases a public API, we will aggregate them immediately.
Reservoir supports fixed (Buy Now) and Dutch auctions. We do not support English auctions at this time. Dutch auction prices are updated every 10 minutes.
We do not support lazy minting at this time.
Reservoir hosted API is currently available on the following chains:
- Goerli (testnet)
- Polygon (beta)
- Optimism (beta)
We plan to roll out support for more EVM compatible chains soon.
Currently, we only offer Goerli as a testnet. You're welcome to make a Feature Request if you'd like Mumbai support here.
We do not currently use OpenRarity ranks for our api. We use PopRank's NFT rankings that you can more about here.
We return both rarity and rarityRank in the tokens API (https://docs.reservoir.tools/reference/gettokensv5).
rarity is a score based on the frequencies of each trait given to each token within a collection.
rarityRank is a rank given to each each token within a collection based on their
rarity. In most cases we recommended using
rarity is based on trait frequency, collections with few or no traits will not provide accurate
We filter out single token bids that are 80% below the floor price. This is to reduce spam due to there being large volumes of bids with low chances of being accepted.
We show 100% of collection wide and trait wide bids.
Reservoir orders get distributed to any application that natively ingests orders from the aggregated orderbook. While Reservoir native orders are not automatically pushed to OpenSea, we make it possible (and easy) to publish orders into the OpenSea orderbook using our Router contract or API.
With our easy-to-use APIs apps built on Reservoir have full control over marketplace and royalty fees. You can read more about royalties here.
Marketplace fees are built into the order. Referral fees are taken on top when filling the order. (e.g. You could take fees on top when filling an OpenSea order that already has a marketplace fee built-in)
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).
Register for an API key here. If you want to just test out the API first, feel free to query without the key.
Wrapped 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.
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.
Token metadata is never automatically refreshed, but may be manually refreshed here.
Collection metadata is updated at 23:30 UTC daily for:
- Top 500 Collection by 24hr Volume
- Collections Minted 1 Day Ago
- Collections Minted 7 Days Ago
Collections can also be manually refreshed here.
Caution: These APIs should be used in moderation, like only when missing data is discovered. Calling it in bulk / programmatically will result in your key getting rate limited.
We offer a top bids websocket (beta). You can read more about it here.
We use QuickNode. But when a user is purchasing, it uses their own RPC.
The ethereum contract address for the Reservoir router is: 0x178a86d36d89c7fdebea90b739605da7b131ff6a (etherscan)
Yes the router contract has been audited by Consensys Dilligence. You can find more details here.
Updated 1 day ago