Blur API

Access Blur data & trading through Reservoir's developer tools

Getting Started with Blur on Reservoir

Reservoir offers access to Blur & 150+ other marketplaces through our simple, and powerful APIs, SDKs & UI kits. To get started you can get an API key which has a generous free plan & affordable paid subscriptions. Blur orders and data are included in all of our endpoints. We also include Blend orders, Blur's lending protocol. However, should you want to access Blur data and trading specifically, you can. The following sections outline how to access Blur data and trading using Reservoir.

Getting Blur Data & Orders

  • Sales - Get Blur Sales from our Sales API. Filtering using the API is not currently supported, so get all sales for a token, collection, or attribute, and filter on the front end using "orderSource": "blur.io"or "fillSource": "blur.io". When using orderSource you are filtering by sales whose orders are native to Blur, while filtering on fillSource will return all sales that were filled on Blur, regardless of the order origination marketplace.
  • Asks (Listings) - Blur asks (listings) can be accessed through our Asks API. To get Blur listings, ensure to set the sources=blur.io. An example of the response.
  • Bids (Offers) - Blur bids (offers) can be accessed through our Bids API. To get Blur Offers, ensure to set the sources=blur.io. An example of the response. When sources=blur.io and includeDepth=true are passed, individual bids will be shown; otherwise Blur bids are pooled. Pass a maker and source=blur.io to see a maker's Blur specific bids; if only maker is passed, the maker's Blur bids will not be revealed. Please note our quantity of bids might be different than Blur's because we pool the bids.

Trading on Blur through Reservoir

  • Buying - Get the listings data and fill those orders either using the API or SDK (recommended)
  • Selling - Get the bid data and fill the bids either using the API or SDK (recommended)
  • Creating Asks (Listings) - Create the listing through the API or the SDK (recommended), set the "orderKind": "blur" & "orderbook": "blur" and check the cross-post status
  • Creating Bids (Offers) - Create the offer through the API or the SDK (recommended) set the "orderKind": "blur" & "orderbook": "blur" and check the cross-post status.

Blur limitations

Blur currently has a small number of restrictions in place:

  • All orders require a signature from the Blur server to be filled
  • To get a signature, the Blur server requires the buyer to sign a message. This signature is saved for 30 days before expiring.
  • Smart contracts wallets / routers/ relayers cannot sign in, fill orders, or create orders.

🚧

Filter Blur Orders Out with excludeEOA

To exclude Blur orders for APIs, please mark excludeEOA as true: buy token, sell token, User Top Bids, Bids (offers), and Asks (listings). With the SDK, you can add excludeEOA: true as an option: buyToken or acceptOffer.
Smart contract wallets / routers should exclude Blur orders as they cannot sign / fill orders.

These restrictions mean that filling Blur orders comes with limitations:

  • Before buying, users need to sign a message to sign into Blur
  • Blur purchases can only be combined with purchases from marketplaces that the Blur router already supports (OpenSea, LooksRare, X2Y2). If you try to purchase from other marketplaces, we will break it into multiple transactions
  • Features like normalizing royalties or collecting fees on top are not possible, because they require usage of the Reservoir Router contract
  • If you accept an offer, you'll receive Blur Pool ETH, not ETH or WETH in your wallet, which needs to be withdrawn in a separate transaction

We do our best to abstract these limitations from end users and developers, making the experience as seamless as possible.

Hopefully, over time Blur will be upgraded, and some of these limitations removed.

Blur Overview

Blur has quickly become one of the most popular NFT marketplaces, and it is one of the largest platforms for NFTs by volume. The platform is well-designed and easy to use, and it offers a number of features that are not available on other marketplaces. If you are looking to buy or sell NFTs, Blur is a great option.

Some core features & background about Blur:

  • The platform is built on the Ethereum blockchain & has no marketplace fees.
  • Blur is backed by a number of venture capital firms, including Paradigm.
  • The platform has over 146,000 users and has facilitated over $1.4 billion in trading volume.

Blur is a rapidly growing NFT marketplace that has quickly become a major player in the industry. The platform offers a number of features that are not available on other marketplaces, and it is well-positioned to attract both professional and casual NFT traders.