Jump to Content
Reservoir
DocsAPI Reference
Reservoir
DocsAPI Reference

Overview

  • What is Reservoir?
  • API Key & Rate Limits
  • Supported Marketplaces
  • Supported Chains
  • FAQs

NFT Trading InFrastructure

  • Overview
  • NFT Liquidity Router
  • Global NFT Orderbook
    • Data Lake
    • Indexer
  • NFT Data API

Marketplace Toolkit

  • Overview
  • Reservoir SDK (JS/TS/Node)
    • Typescript API Typings
    • buyToken
    • listToken
    • placeBid
    • acceptOffer
    • cancelOrder
    • Add Sweeping
  • ReservoirKit UI (React)
    • Add Buying
    • Add Listing
    • Add Bidding
    • Accept a Bid
    • Add a Cart
    • Cancel a Listing
    • Cancel a Bid
    • Edit a Listing
    • TokenMedia
    • Troubleshooting
    • Theming
  • ReservoirKit Hooks
    • useTokens
    • useCollections
    • useCollectionActivity
    • useUsersActivity
    • useTokenActivity
    • useListings
    • useOwnerListings
    • useReservoirClient
    • useTokenOpenseaBanned
    • useAttributes
    • useBids
    • useUserTopBids
    • useUserCollections
    • useUserTokens
    • useCart
    • useDynamicTokens
  • Marketplace UI (NextJS)
  • Dune Dataset
  • Reservoir API

Use Cases

  • Build a Custom Marketplace
  • Embed Buying and Selling
  • Access Market Data
  • Trade Programmatically
  • Integrating a New Marketplace
    • Understanding Sales
    • Filling Existing Liquidity
    • Full Support
  • Sync with Reservoir

I'm building a..

  • Wallet/Portfolio App
  • NFT Discord Bot

Features

  • Marketplace Source Attribution
  • Instant Sell
  • Buy & Sweep
  • Bulk Order Creation
  • Floor Prices
  • Custom ERC-20 Support
  • Flagged Tokens
  • Royalties
  • Custom Fees
  • Websocket Events [BETA]
    • Payloads
  • Accessing Native Reservoir Liquidity
  • Self-hosting

Guides

  • Marketplace Fees & Royalties
  • Blur Limitations
  • Filling Orders Explainer

Resources

  • Building with Reservoir
  • Security and Smart Contract Audits
  • Glossary
  • Logos
  • Support

Supported Chains

Suggest Edits

The Reservoir hosted API is currently available on the following chains:

  • Ethereum - https://api.reservoir.tools/
  • Goerli (testnet) - https://api-goerli.reservoir.tools/
  • Polygon - https://api-polygon.reservoir.tools/
  • Arbitrum (beta) - https://api-arbitrum.reservoir.tools/
  • Optimism (beta) - https://api-optimism.reservoir.tools/

More chains coming soon. Visit https://reservoir.productlane.io/ and have your say on what we should support next.

Updated 3 days ago