blur.io APIblur.io ↗
Retrieve Blur.io NFT collection data: floor prices, best bids, listed tokens, sales activity, and wallet portfolios via 8 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/9383f30f-7b43-4d7b-b5fa-f521cc6fb20c/get_collections?sort=VOLUME_ONE_DAY&order=DESC' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch a list of NFT collections sorted by volume or other metrics. Returns paginated collection summaries with floor prices, volume stats, and bid data.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort field. Accepted values: VOLUME_ONE_DAY, VOLUME_ONE_WEEK, VOLUME_FIFTEEN_MINUTES. |
| order | string | Sort order. Accepted values: ASC, DESC. |
{
"type": "object",
"fields": {
"totalCount": "integer total number of collections available",
"collections": "array of collection summary objects with name, slug, floorPrice, volume stats, and bestCollectionBid"
},
"sample": {
"data": {
"totalCount": 14987,
"collections": [
{
"name": "BoredApeYachtClub",
"floorPrice": {
"unit": "ETH",
"amount": "10.07"
},
"volumeOneDay": {
"unit": "ETH",
"amount": "136.426"
},
"collectionSlug": "boredapeyachtclub",
"contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"bestCollectionBid": {
"unit": "ETH",
"amount": "9.5"
}
}
]
},
"status": "success"
}
}About the blur.io API
The Blur.io API exposes 8 endpoints covering NFT collection metadata, real-time floor prices, bid data, token listings, and trading activity from the Blur marketplace. Use get_collections to paginate ranked collections sorted by one-day or one-week volume, or get_collection_activity to stream recent sales and listing events with trader addresses and per-event pricing.
Collection Data
The get_collections endpoint returns a paginated list of NFT collections sortable by VOLUME_ONE_DAY, VOLUME_ONE_WEEK, or VOLUME_FIFTEEN_MINUTES in ascending or descending order. Each summary includes floorPrice, volume stats, and bestCollectionBid. For a single collection, get_collection accepts a collection_slug (e.g. pudgypenguins) and returns the full metadata object: contractAddress, traitFrequencies, volumeOneDay, and bid information in one response.
Pricing and Bid Endpoints
get_collection_floor_price returns the current floor price alongside historical snapshots — floorPriceOneDay and floorPriceOneWeek — each expressed as an amount and unit object. get_collection_best_bid isolates the highest active collection-wide offer (bestCollectionBid) and the aggregate totalCollectionBidValue, useful for gauging market depth without pulling the full collection record.
Token Listings and Activity
get_collection_tokens fetches tokens currently listed for sale in a collection. Each token object carries tokenId, imageUrl, traits, price, rarityRank, and owner. get_collection_activity returns an events array covering sales and order creations; each event includes eventType, price, fromTrader, toTrader, createdAt, and marketplace — enabling per-trade audit trails.
Authentication and Portfolio
Two endpoints support wallet-authenticated workflows. login accepts a wallet_address, a challenge_message, and a signature, and returns an accessToken JWT. With an active session, get_portfolio returns NFT holdings for a given wallet address, surfacing portfolio data tied to that account on Blur.
- Track floor price trends over one day and one week for a set of NFT collections using
get_collection_floor_price. - Monitor collection-wide bid depth by polling
bestCollectionBidandtotalCollectionBidValueacross top collections. - Build a rarity-sorted token viewer for any Blur-listed collection using
rarityRankandtraitsfromget_collection_tokens. - Aggregate recent sales history with buyer/seller wallet addresses from
get_collection_activityfor wash-trade analysis. - Rank collections by short-term momentum using
VOLUME_FIFTEEN_MINUTESsort inget_collections. - Fetch a wallet's NFT holdings on Blur via
get_portfolioafter authenticating with a signed message. - Compare floor price to best collection bid across multiple slugs to identify collections with compressed bid-ask spreads.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Blur have an official developer API?+
What does `get_collection_activity` return, and does it distinguish event types?+
get_collection_activity returns an events array where each object includes an eventType field (covering sales and order creations), the price, fromTrader, toTrader, createdAt timestamp, and marketplace. This lets you filter for completed sales versus new listings in your own logic.Does the API support filtering token listings by trait, price range, or rarity?+
get_collection_tokens returns tokens with traits, price, and rarityRank fields, but the endpoint does not currently accept filter parameters — all listed tokens for a collection are returned and filtering must be done client-side. You can fork this API on Parse and revise it to add trait or price-range filter inputs.