Documentation Index Fetch the complete documentation index at: https://docs.dropkit.co/llms.txt
Use this file to discover all available pages before exploring further.
Interactive GraphQL Explorer Explore the complete DropKit GraphQL schema, run queries, and test mutations directly in your browser.
Quick Start 1. Authentication First, authenticate your requests by adding your API token to the headers:
{ "Authorization" : "Bearer YOUR_API_TOKEN" }
2. Explore the Schema Use the Docs panel (📖) to browse all available types, queries, and mutations:
Query - Read operations for drops, tokens, users, and moreMutation - Write operations for creating, updating, and deleting resourcesSubscription - Real-time updates for live data
3. Try Sample Queries Get Drops query GetDrops { drops { id name type status price priceUSD totalSupply claimedAmount creator { username displayName } } }
Get User Profile query GetUser ( $id : ID ! ) { user ( id : $id ) { id username displayName email createdAt drops { id name status } } }
Create a Token mutation CreateToken ( $input : CreateTokenInput ! ) { createToken ( input : $input ) { id name symbol status totalSupply createdAt } }
Explorer Features 🔍 Schema Introspection
Browse all available types, fields, and descriptions
View field arguments and return types
Explore enum values and input types
🧪 Query Testing
Write and execute queries in real-time
Auto-complete for types and fields
Syntax highlighting and error detection
📚 Interactive Documentation
Click on any type or field to see documentation
Navigate through type relationships
View examples and usage patterns
🔧 Request Configuration
Set custom headers for authentication
Configure variables for dynamic queries
Save and share query configurations
Schema Overview Root Types type Query { # Drops drops : [ Drop ! ] ! drop ( id : ID ! ): Drop # Tokens tokens : [ Token ! ] ! token ( id : ID ! ): Token # Users users : [ User ! ] ! user ( id : ID ! ): User # Claims claims : [ Claim ! ] ! claim ( id : ID ! ): Claim # Payments paymentIntents : [ PaymentIntent ! ] ! paymentIntent ( id : ID ! ): PaymentIntent # Gating checkEligibility ( input : CheckEligibilityInput ! ): EligibilityResult ! gatingTemplates : [ GatingTemplate ! ] ! # Events events : [ Event ! ] ! event ( id : ID ! ): Event # Webhooks webhooks : [ Webhook ! ] ! webhook ( id : ID ! ): Webhook } type Mutation { # Drop Management createDrop ( input : CreateDropInput ! ): Drop ! updateDrop ( input : UpdateDropInput ! ): Drop ! deleteDrop ( input : DeleteDropInput ! ): Boolean ! # Token Creation createToken ( input : CreateTokenInput ! ): Token ! confirmTokenDeployment ( input : ConfirmTokenDeploymentInput ! ): Token ! # Claims createClaim ( input : CreateClaimInput ! ): Claim ! confirmClaim ( input : ConfirmClaimInput ! ): Claim ! # Payments createPaymentIntent ( input : CreatePaymentIntentInput ! ): PaymentIntent ! confirmPaymentIntent ( input : ConfirmPaymentIntentInput ! ): PaymentIntent ! processRefund ( input : ProcessRefundInput ! ): Refund ! # Webhooks createWebhook ( input : CreateWebhookInput ! ): Webhook ! updateWebhook ( input : UpdateWebhookInput ! ): Webhook ! deleteWebhook ( input : DeleteWebhookInput ! ): Boolean ! testWebhook ( input : TestWebhookInput ! ): WebhookTestResult ! # File Management uploadFile ( input : UploadFileInput ! ): FileUpload ! deleteFile ( input : DeleteFileInput ! ): Boolean ! } type Subscription { # Real-time drop updates dropUpdates ( dropId : ID ! ): DropUpdate ! # Live claim notifications claimNotifications ( userId : ID ! ): ClaimNotification ! # Payment status updates paymentUpdates ( paymentIntentId : ID ! ): PaymentUpdate ! # Event streams eventStream ( types : [ String ! ]): Event ! }
Core Types Drop type Drop { id : ID ! name : String ! description : String type : DropType ! status : DropStatus ! # Pricing price : Float ! priceUSD : Float ! currency : String ! # Supply totalSupply : BigInt ! claimedAmount : BigInt ! remainingBalance : BigInt ! # Metadata imageUrl : String metadata : JSON # Relationships creator : User ! token : Token claims : [ Claim ! ] ! # Computed fields isActive : Boolean ! isSoldOut : Boolean ! percentClaimed : Float ! # Timestamps createdAt : DateTime ! updatedAt : DateTime ! }
Token type Token { id : ID ! name : String ! symbol : String ! decimals : Int ! totalSupply : BigInt ! description : String imageUrl : String # Blockchain data address : String packageId : String coinType : String # Status status : TokenStatus ! isExternal : Boolean ! # Distribution communityDropsReserve : BigInt ! publicSaleReserve : BigInt ! creatorReserve : BigInt ! # Relationships creator : User ! drops : [ Drop ! ] ! # Timestamps createdAt : DateTime ! updatedAt : DateTime ! }
User type User { id : ID ! username : String ! displayName : String email : String bio : String avatarUrl : String # Authentication privyId : String ! walletAddress : String # Relationships drops : [ Drop ! ] ! tokens : [ Token ! ] ! claims : [ Claim ! ] ! # Computed fields totalDrops : Int ! totalClaims : Int ! # Timestamps createdAt : DateTime ! updatedAt : DateTime ! }
Advanced Features Variables and Fragments Use variables to make your queries dynamic:
query GetDropWithClaims ( $dropId : ID ! , $limit : Int = 10 ) { drop ( id : $dropId ) { ... DropDetails claims ( limit : $limit ) { ... ClaimDetails } } } fragment DropDetails on Drop { id name type status price priceUSD totalSupply claimedAmount creator { username displayName } } fragment ClaimDetails on Claim { id amount status createdAt user { username } }
Subscriptions Test real-time subscriptions:
subscription LiveDropUpdates ( $dropId : ID ! ) { dropUpdates ( dropId : $dropId ) { type drop { id claimedAmount remainingBalance isActive } timestamp } }
Introspection Explore the schema programmatically:
query IntrospectionQuery { __schema { types { name description fields { name type { name } } } } }
Tips for Using the Explorer 1. Use Auto-Complete
Press Ctrl+Space to trigger auto-completion
Use Ctrl+Enter to execute queries
Press Ctrl+/ to comment/uncomment lines
2. Navigate with Keyboard
F1 - Open command paletteCtrl+D - Select next occurrenceCtrl+Shift+L - Select all occurrences
3. Save Your Work
Use the History tab to revisit previous queries
Save frequently used queries as Favorites
Export queries to share with your team
4. Test Error Handling
Try invalid field names to see error messages
Test required field validation
Experiment with different input types
API Endpoint The GraphQL endpoint is available at:
https://api.dropkit.co/graphql
For development and testing:
https://api-dev.dropkit.co/graphql
Authentication Include your API token in the Authorization header:
curl -X POST \ https://api.dropkit.co/graphql \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query": "query { drops { id name } }"}'
Need Help?
Pro Tip Use the prettify button (⌘+Shift+P) to format your queries and make them
more readable.
