Getting Started with Ethereum on Reservoir

Reservoir offers access to Ethereum & a number of EVM-compatible chains through our simple, yet powerful APIs, SDKs & UI kits for NFT trading and data. To get started you can get an API key which has a generous free plan & affordable paid subscriptions.

• Ethereum API Base URL - You can access all Reservoir APIs by using the https://api.reservoir.tools/ base URL. When using the API reference docs for Ethereum, make sure to change the base URL to the one above.
• Recommended Test Collection - Our recommended Ethereum NFT collection to test with is Blitmap contract address: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63. When using the API reference docs, use the collection above to test responses.

To get a better sense of what we offer, checkout of reference Ethereum marketplace.

Access Ethereum Data with Reservoir

Reservoir gives you access to complete NFT metadata and market data aggregated from across all major marketplaces including Opensea, Blur, X2Y2, and more. You can learn more about our available data in our NFT Data Overview.

• Get Aggregated Ethereum Listings - sample response
• Get Aggregated Ethereum Offers - sample response
• Get Ethereum Floor Prices - sample response
• Get Ethereum Sales Volume - sample response
• Get Ethereum Collection Metadata - sample response

Trading on Ethereum with Reservoir

Reservoir makes it simple to not only get market data and orders, but execute and create orders directly through our APIs and tools. To learn more about trading with Reservoir, check out our NFT Trading Overview. On Ethereum, you can:

Execute orders from across major marketplaces, by using the trading APIs or the SDK, which wraps the APIs into simple methods. Check out the buy and sell endpoints below:

• Buy Ethereum NFTs
• Sell Ethereum NFTs

Create orders with custom fees and royalties that will get distributed across the Reservoir ecosystem. Or cross-post orders to major marketplaces that have Ethereum support. Check out our list and bid endpoints below:

• List Ethereum NFTs
• Bid on Ethereum NFTs

Reservoir Tools Available on Ethereum

All Reservoir tools including APIs, SDKs & ReservoirKit have full Ethereum support.

Understanding Ethereum

Ethereum, a pioneering blockchain platform, provides a robust infrastructure for Non-Fungible Tokens (NFT) marketplaces, setting itself apart from other blockchains through its unique features. Its groundbreaking functionalities, such as Smart Contracts, the ERC-721 standard, decentralization, and large-scale adoption, have shaped the thriving NFT landscape.

Ethereum Blockchain Features

1. Smart Contracts: At the heart of Ethereum are smart contracts - self-executing contracts with the terms of the agreement directly written into lines of code. These allow for secure and trustless transactions, making it perfect for conducting trades on NFT marketplaces.
2. ERC-721 Standard: Ethereum introduced a standard for NFTs known as ERC-721. This standard ensures that each token is unique, distinguishing Ethereum from other blockchains and making it ideal for minting and trading NFTs.
3. Decentralization: Ethereum's decentralized nature makes it immune to censorship and gives it resilience to attempts of control. This appeals to artists and creators who wish to have total ownership of their work.
4. Large-scale Adoption: As one of the first widely adopted blockchains, Ethereum is the backbone of many NFT transactions.