How Drops Work
The Drops API follows a streamlined four-stage model:- Drop Creation - Drops are created through the Project Wallet deploy-drop feature
- User Discovery - Users find available drops through your application
- Claim Processing - Users claim NFTs through the Drops API
- NFT Distribution - Successfully claimed NFTs are automatically minted and transferred
Integration Workflow
1. Fetch Drop Information
Retrieve drop information including availability, pricing, and claim conditions to determine eligibility and provide user guidance.2. Process Claims
Process NFT claims through automated payment handling (for paid drops) and minting initiation.3. Handle Responses
Monitor claim status through transaction details for minting progress tracking and error handling.API Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/drops/{chainId}/{contractAddress} | Get drop information |
POST | /v1/drops/claim | Claim NFTs from drop |
Error Handling
The API returns standard HTTP status codes:- 400 - Invalid request parameters (validation errors)
- 404 - Drop not found for the specified chainId and contractAddress
- 500 - Internal server errors (network issues, SDK failures)
Getting Started
- Set up Project Wallet - Configure authentication and wallet access
- Deploy a Drop - Create your NFT contract with drop conditions
- Integrate the API - Add drop fetching and claim processing to your application