Instant Sell

Learn how to add instant sell into your product with Reservoir.

Instant selling enables users to sell their token at a fair market price without having to experience the hassle of listing on a marketplace, a process that is time consuming and uncertain. Developer teams can easily add this functionality to their products with Reservoir.

How does it work?

Reservoir aggregates the best bids from all major sources (including marketplaces and professional marketplace makers) making them available via a simple API. These bids can then be filled with ReservoirKit.

How do I add this to my product?

While there are many ways to take advantage of Reservoir’s aggregated bid liquidity, below is one example of how to add instant sell into your product in two simple steps.

  1. Find a user’s best bids from all their tokens using user-top-bids endpoint.

Example:
https://api.reservoir.tools/orders/users/{walletAddress}/top-bids/v1?optimizeCheckoutURL=false&normalizeRoyalties=false&sortBy=floorDifferencePercentage&sortDirection=des
c&limit=20

  1. Initiate ResevoirKit’s AcceptBidModal when user clicks Sell to accept the bid and handle the execute steps.