Drops Endpoints

Get drops

Changed on Nov 3, 2026

Get a list of NFT drops (mints) by type: featured, upcoming, or recently_minted. Results may be fewer than the requested limit due to post-fetch filtering.

get/api/v2/drops

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/drops/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

typestring

Drop calendar type: featured, upcoming, or recently_minted

limitinteger

Number of results to return (1-100, default: 20)

chainsChainIdentifier[]

Comma-separated list of chains to filter by (e.g. ethereum, base). Omit to return drops on all chains.

[
  "ethereum"
]

cursorstring

Pagination cursor for next page

Response

Paginated list of drops

nextstring nullable

Cursor for the next page. May be present even when drops is empty if all items in the page were filtered by visibility rules; continue paginating until next is null.

Example response

{
  "drops": [
    {
      "active_stage": {
        "allowlist_wallet_count": 1200,
        "stage_type": "public_sale",
        "uuid": "5f0c6f7e2b8a4c1d9e3f6a7b8c9d0e1f"
      },
      "chain": "ethereum",
      "collection_name": "Cool Cats",
      "collection_slug": "cool-cats",
      "drop_type": "seadrop_v1_erc721",
      "next_stage": {
        "allowlist_wallet_count": 1200,
        "stage_type": "public_sale",
        "uuid": "5f0c6f7e2b8a4c1d9e3f6a7b8c9d0e1f"
      }
    }
  ]
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  removed the enum value b3 from the property items/ of the query request parameter chains
- breaking
  removed the enum value blast from the property items/ of the query request parameter chains
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- info
  added the enum value stablechain to the property items/ of the query request parameter chains
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status

Operation history