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.