Skip to main content
POST
/
api
/
blur
/
collections
/
tokens
/blur/collections/tokens
curl --request POST \
  --url https://api.anysite.io/api/blur/collections/tokens \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "collection": "<string>",
  "count": 2,
  "timeout": 300,
  "listed_only": true,
  "traits": {
    "Background": [
      "Dark Purple"
    ]
  },
  "price_min": 1,
  "price_max": 1,
  "rarity_rank_min": 2,
  "rarity_rank_max": 2
}
'
[
  {
    "token_id": "<string>",
    "@type": "BlurToken",
    "name": "<string>",
    "image": "<string>",
    "traits": {},
    "rarity_score": 123,
    "rarity_rank": 123,
    "price": {
      "@type": "BlurPrice",
      "amount": 123,
      "unit": "<string>",
      "listed_at": "<string>",
      "marketplace": "<string>"
    },
    "highest_bid": {
      "@type": "BlurPrice",
      "amount": 123,
      "unit": "<string>",
      "listed_at": "<string>",
      "marketplace": "<string>"
    },
    "last_sale": {
      "@type": "BlurPrice",
      "amount": 123,
      "unit": "<string>",
      "listed_at": "<string>",
      "marketplace": "<string>"
    },
    "last_cost_basis": {
      "@type": "BlurPrice",
      "amount": 123,
      "unit": "<string>",
      "listed_at": "<string>",
      "marketplace": "<string>"
    },
    "owner": {
      "address": "<string>",
      "@type": "BlurTrader",
      "username": "<string>"
    },
    "owner_owned_count": 123,
    "is_suspicious": false
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
collection
string
required

Collection slug (e.g. 'azuki') or its on-chain contract address

Minimum string length: 1
Examples:

"azuki"

"0xed5af388653567af2f388e6224dc7c4b3241c544"

​
count
integer
required

Number of tokens to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
listed_only
boolean
default:true

Only return tokens currently listed for sale

​
traits
object

Filter to tokens matching the given trait values, keyed by trait name (e.g. {"Background": ["Dark Purple"], "Type": ["Human"]})

Example:
{ "Background": ["Dark Purple"] }
​
price_min
number | null

Only return tokens priced at or above this amount

Required range: x >= 0
​
price_max
number | null

Only return tokens priced at or below this amount

Required range: x >= 0
​
rarity_rank_min
integer | null

Only return tokens with rarity rank at or above this value (1 = rarest)

Required range: x >= 1
​
rarity_rank_max
integer | null

Only return tokens with rarity rank at or below this value (1 = rarest)

Required range: x >= 1

Response

Successful Response

​
token_id
string
required
​
@type
string
default:BlurToken
​
name
string | null
​
image
string | null
​
traits
object
​
rarity_score
number | null
​
rarity_rank
integer | null
​
price
object
​
highest_bid
object
​
last_sale
object
​
last_cost_basis
object
​
owner
object
​
owner_owned_count
integer | null
​
is_suspicious
boolean
default:false