Skip to main content

GET floor_price

/v1/floor_price

Get the floor price in a given collection.

Limit

/v1/floor_price?limit={maxNumber}

Range: 0 → 1400

The default value of limit is 50, if you don't specify a value, this value be adopted.

Offset

/v1/floor_price?offset={numToAvoid}

The default value of offset is 0, if you don't specify a value, 0 will be adopted.

Queries

You can filter transactions to get more specific results.

1. Collection name

/v1/floor_price?collection_name={name}

Filter floor price by the collection name.

2. Marketplace

/v1/floor_price?marketplace={value}

Filter floor price by the the marketplace.

3. Blockchain

/v1/floor_price?blockchain={value}

Filter floor price by blockchain.

Possible values:

  • ethereum
  • tron
  • polygon

4. From date

/v1/floor_price?from_date={value}

Filter floor price starting from a date.

5. To date

/v1/floor_price?to_date={value}

Filter floor price finishing in a given date.

Order

1. Order by

/v1/floor_price?oder_by={order}

Possible values:

  • date (default)
  • price

2. Order direction

/v1/floor_price?order_direction={order}

Possible values:

  1. asc → represents an order that starts at the lowest value and ends at the highest reference value
  2. desc → represents an order that starts at the highest value and ends at the lowest reference value

The default value of order_direction is asc , if you don't specify a value, this value will be adopted.

Note: Values are case-insensitive

Expected return

An array of NFTs.

{
"paging": {
"total": 22415,
"pages": 17,
"page": 1
},
"response": [
{
"collection_name": "doodles-official",
"marketplace": "opensea",
"blockchain": "Ethereum",
"price": "17000000000000000000",
"date": "2022-04-05T21:12:32.000Z"
}
]
}
Errors

400 Invalid Request

Your request is malformed. Please, check the documentation out.

401 API key is invalid

You did not pass the API key for getting authorization.

404 Data not found

Your request returned with no matches.

429 Too many requests

You are hiting the API request limit.

500 Internal server error

The server did not know how to handle this error.