Blur APIblur.io ↗
Access Blur.io NFT data via API: collection rankings, floor prices, best bids, listed tokens, and trading activity across thousands of collections.
What is the Blur API?
The Blur.io API provides 7 endpoints for accessing NFT marketplace data from blur.io, covering collection rankings, floor price history, bid depth, listed tokens, and on-chain trading activity. The get_collections endpoint returns ranked summaries across thousands of collections in a single call, while get_collection_activity exposes per-event trade records including trader addresses, prices, and timestamps.
curl -X GET 'https://api.parse.bot/scraper/9383f30f-7b43-4d7b-b5fa-f521cc6fb20c/get_collections?sort=VOLUME_ONE_DAY&order=ASC' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch a ranked list of NFT collections sorted by trading volume or other metrics. Returns collection summaries including floor prices, volume stats across multiple time windows, and current best bid. The full ranking contains thousands of collections; a single call returns one page of results.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort field for ranking collections. |
| order | string | Sort order. |
{
"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": 15000,
"collections": [
{
"name": "PudgyPenguins",
"imageUrl": "https://images.blur.io/_blur-prod/0xbd3531da5cf5857e7cfaa92426877b022e612cf8/3369-457f5fc4272cd976",
"floorPrice": {
"unit": "ETH",
"amount": "4.41498799999998"
},
"totalSupply": 8888,
"numberOwners": 5210,
"volumeOneDay": {
"unit": "ETH",
"amount": "116.519174529998258"
},
"volumeOneWeek": {
"unit": "ETH",
"amount": "1156.750235639980833807"
},
"collectionSlug": "pudgypenguins",
"contractAddress": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"floorPriceOneDay": {
"unit": "ETH",
"amount": "4.387972399997239"
},
"bestCollectionBid": {
"unit": "ETH",
"amount": "4.3"
},
"floorPriceOneWeek": {
"unit": "ETH",
"amount": "4.10989249998924"
},
"volumeFifteenMinutes": {
"unit": "ETH",
"amount": "4.427"
},
"totalCollectionBidValue": {
"unit": "ETH",
"amount": "165.63"
}
}
]
},
"status": "success"
}
}About the Blur API
Collection Rankings and Metadata
The get_collections endpoint returns a paginated ranked list of NFT collections, each summary including floorPrice, volume statistics across multiple time windows, and bestCollectionBid. The sort and order parameters control ranking direction. For deeper metadata on a single collection, get_collection accepts a collection_slug (e.g. pudgypenguins) and returns the full object including contractAddress, traitFrequencies, supply counts, and ownership figures.
Floor Price and Bid Data
get_collection_floor_price returns three floor price snapshots — current, one day ago (floorPriceOneDay), and one week ago (floorPriceOneWeek) — with each value expressed as an object carrying amount and unit. This avoids fetching the full collection object when you only need price trend data. get_collection_best_bid returns the highest active collection-wide offer (bestCollectionBid) and the aggregate totalCollectionBidValue, which together indicate buyer demand and the bid-ask spread.
Listed Tokens and Activity
get_collection_tokens returns only tokens with active ask orders, each record including tokenId, imageUrl, traits, price, rarityRank, and owner. Collections with no active listings return an empty array and a totalCount of zero. get_collection_activity returns an array of recent events (sales and order creations) with fields including eventType, price, fromTrader, toTrader, createdAt, and marketplace.
Search
search_collections accepts either a contract_address (0x-prefixed Ethereum address) or a partial collection_name. Results include up to 10 matching collections per call with totalSupply, numberOwners, floorPrice, volumeOneDay, and bestCollectionBid. The matchedBy field in the response identifies which input parameter produced the rows, and failedDetails lists any slugs whose detail lookup returned incomplete data.
The Blur API is a managed, monitored endpoint for blur.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when blur.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official blur.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track NFT collection floor price trends over 1-day and 1-week windows using
get_collection_floor_price - Monitor bid-ask spreads by comparing
bestCollectionBidtofloorPriceacross top-ranked collections - Build a rarity-based token picker by filtering
get_collection_tokensresults byrarityRankandprice - Detect wash trading patterns by cross-referencing
fromTraderandtoTraderaddresses in activity events - Look up a collection's contract address and supply stats by searching with a partial name via
search_collections - Aggregate daily trading volume across collections using
volumeOneDayfrom the rankedget_collectionsresponse - Alert on new listings in a specific collection by polling
get_collection_tokensfor changes intotalCount
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Blur.io have an official developer API?+
What does `get_collection_activity` return, and does it include listing cancellations?+
eventType, price, fromTrader, toTrader, createdAt, and marketplace. Currently exposed event types are sales and order creations. Cancellation events are not included in the current response schema. You can fork this API on Parse and revise it to add a cancellation event filter if needed.Does the API return individual token bid offers, or only collection-wide bids?+
get_collection_best_bid, which returns bestCollectionBid and totalCollectionBidValue. Per-token trait-level or individual token bids are not currently returned. You can fork this API on Parse and revise it to add a per-token bid endpoint.How does pagination work in `get_collections`?+
totalCount integer reflecting the full number of collections available. The ranking can contain thousands of entries. There is no cursor or offset parameter exposed in the current API — only sort and order are accepted as inputs.