---
updatedAt: 2026-09-04T04:30:09.000Z
agentTools:
  projectIndex: https://docs.opensea.io/llms.txt
---

# Get trait floor prices

Get the cheapest active listing for every trait value in a collection, in one request. Trait values with no active listing are omitted. Results are ordered by trait type, then value, then price.

Only traits with text values are included. A numeric trait has no enumerable set of values, so it is reported as a min/max range by 'GET /api/v2/traits/{slug}' rather than as a floor per value here.

Prices come from each item's best listing across every marketplace OpenSea aggregates, the same basis as 'floor_price' in 'GET /api/v2/collections/{slug}/stats'. A floor can therefore be below the cheapest listing fulfillable through this API, because 'GET /api/v2/listings/collection/{slug}/best' serves only the OpenSea order book.

Prices are not converted to a common currency: a trait value listed in more than one currency appears once per currency, and prices are only comparable within the same 'payment_token_symbol'.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "OpenSea API",
    "description": "The API for OpenSea",
    "contact": {
      "name": "OpenSea",
      "url": "https://www.opensea.io",
      "email": "contact@opensea.io"
    },
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.opensea.io",
      "description": "OpenSea API server"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Collection Endpoints",
      "description": "Collection endpoints to retrieve collection details, traits, and trending data"
    }
  ],
  "paths": {
    "/api/v2/traits/{slug}/floors": {
      "get": {
        "tags": [
          "Collection Endpoints"
        ],
        "summary": "Get trait floor prices",
        "description": "Get the cheapest active listing for every trait value in a collection, in one request. Trait values with no active listing are omitted. Results are ordered by trait type, then value, then price.\n\nOnly traits with text values are included. A numeric trait has no enumerable set of values, so it is reported as a min/max range by 'GET /api/v2/traits/{slug}' rather than as a floor per value here.\n\nPrices come from each item's best listing across every marketplace OpenSea aggregates, the same basis as 'floor_price' in 'GET /api/v2/collections/{slug}/stats'. A floor can therefore be below the cheapest listing fulfillable through this API, because 'GET /api/v2/listings/collection/{slug}/best' serves only the OpenSea order book.\n\nPrices are not converted to a common currency: a trait value listed in more than one currency appears once per currency, and prices are only comparable within the same 'payment_token_symbol'.",
        "operationId": "get_collection_trait_floors",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "description": "Unique identifier for the specific collection",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "doodles-official"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/TraitFloorsResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Conflict",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "Aggregation timed out; the collection is too large to serve",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "V1ErrorWrapper": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Stable machine-readable error code, on the errors that have one. Branch on it rather than on the message text, which may change.",
            "example": "MINTER_NOT_ELIGIBLE"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "errors"
        ]
      },
      "TraitFloorResponse": {
        "type": "object",
        "description": "Floor price for one trait value in one payment currency",
        "properties": {
          "floor_price": {
            "type": "number",
            "format": "double",
            "description": "Price of the cheapest listing carrying this trait value, across every marketplace OpenSea aggregates. This matches the basis of the collection's floor_price and may be below the cheapest listing fulfillable through this API."
          },
          "payment_token_symbol": {
            "type": "string",
            "description": "Payment token this floor is denominated in, on the response's chain. Floors are not converted to a common currency, so a trait value listed in more than one currency appears once per currency and prices are only comparable within the same symbol."
          },
          "trait_type": {
            "type": "string",
            "description": "Trait category, for example Background"
          },
          "value": {
            "type": "string",
            "description": "Trait value, for example Purple"
          }
        },
        "required": [
          "floor_price",
          "payment_token_symbol",
          "trait_type",
          "value"
        ]
      },
      "TraitFloorsResponse": {
        "type": "object",
        "description": "Floor price per trait value for a collection",
        "properties": {
          "chain": {
            "type": "string",
            "description": "Chain every floor in this response is denominated on. A collection lives on one chain, so the payment token is identified by this plus 'payment_token_symbol'."
          },
          "floors": {
            "type": "array",
            "description": "One entry per text trait value and payment currency that has at least one active listing, ordered by trait type, then value, then price. Numeric traits are not enumerated here; see GET /api/v2/traits/{slug} for their min/max range.",
            "items": {
              "$ref": "#/components/schemas/TraitFloorResponse"
            }
          }
        },
        "required": [
          "chain",
          "floors"
        ]
      }
    },
    "responses": {
      "BadRequest": {
        "description": "For error reasons, review the response data.",
        "content": {
          "*/*": {
            "schema": {
              "$ref": "#/components/schemas/V1ErrorWrapper"
            }
          }
        }
      },
      "NotFound": {
        "description": "Resource not found",
        "content": {
          "*/*": {
            "schema": {
              "$ref": "#/components/schemas/V1ErrorWrapper"
            }
          }
        }
      },
      "InternalError": {
        "description": "Internal server error. Please open a support ticket so OpenSea can investigate."
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "description": "API key required for authentication",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Data & Discovery",
      "tags": [
        "Chain Endpoints",
        "Account Endpoints",
        "Collection Endpoints",
        "NFT Endpoints",
        "Contract Endpoints",
        "Token Endpoints",
        "Search Endpoints",
        "Signal Endpoints"
      ]
    },
    {
      "name": "Marketplace & Trading",
      "tags": [
        "Listing Endpoints",
        "Offer Endpoints",
        "Order Endpoints",
        "Swap Endpoints",
        "Drops Endpoints"
      ]
    },
    {
      "name": "Analytics & Events",
      "tags": [
        "Analytics Endpoints"
      ]
    },
    {
      "name": "Tools [Beta]",
      "tags": [
        "Tool Endpoints [Beta]"
      ]
    },
    {
      "name": "Transactions",
      "tags": [
        "Transaction Endpoints"
      ]
    },
    {
      "name": "Authentication",
      "tags": [
        "Auth Endpoints"
      ]
    }
  ]
}
```