Drop API
The Drop API provides endpoints for querying wallet NFT ownership, calculating multipliers, and retrieving drop information.
Overview
The Drop API enables you to:
- Query Wallet NFTs: Get NFT ownership counts by rarity for specific drops
- Calculate Multipliers: Retrieve calculated multipliers based on NFT holdings
- User Levels: Get user levels based on NFT ownership
- Drop Information: Access complete drop details including metadata
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v2/drop/{id}/walletNFTs | Get wallet NFT information and multipliers for a drop |
Authentication
All drop endpoints are public and do not require authentication.
NFT Ownership & Multipliers
The API calculates user multipliers and levels based on NFT ownership:
- Rarity-based Counting: NFTs are grouped by rarity levels
- Multiplier Calculation: System calculates multipliers based on owned NFT quantities and rarities
- Level System: User levels are determined by NFT holdings
- Real-time Data: Ownership data is queried in real-time from blockchain
Multi-Contract Drops
Some drops span multiple contracts or projects:
- hasMultipleContracts: Flag indicating if drop has multiple contracts
- Project ID: Required parameter for multi-contract drops
- Different Multipliers: Each project may have different multiplier calculations
- Separate Tracking: NFT counts are tracked per project within the drop
Response Data
The API provides comprehensive information:
Drop Information
- Complete drop metadata and configuration
- Contract addresses and blockchain details
- Rarity definitions and card information
- Marketplace and phase information
User-Specific Data
- Owned Cards: Count of NFTs by rarity with detailed card information
- Multiplier: Calculated multiplier based on ownership
- Level: User level based on NFT holdings
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 404 | Not Found - Drop not found |