Schema Explorer

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 more
Mutation - Write operations for creating, updating, and deleting resources
Subscription - 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 palette
Ctrl+D - Select next occurrence
Ctrl+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?

Documentation: Check our Query and Mutation guides
Support: Contact us at support@dropkit.co
Community: Join our Discord for community support

Pro Tip

Use the prettify button (⌘+Shift+P) to format your queries and make them more readable.

GraphQL Documentation

Queries

Mutations

Types & Schema

Schema Explorer

Interactive GraphQL Explorer

Quick Start

1. Authentication

2. Explore the Schema

3. Try Sample Queries

Get Drops

Get User Profile

Create a Token

Explorer Features

🔍 Schema Introspection

🧪 Query Testing

📚 Interactive Documentation

🔧 Request Configuration

Schema Overview

Root Types

Core Types

Drop

Token

User

Advanced Features

Variables and Fragments

Subscriptions

Introspection

Tips for Using the Explorer

1. Use Auto-Complete

2. Navigate with Keyboard

3. Save Your Work

4. Test Error Handling

API Endpoint

Authentication

Need Help?

Pro Tip

​Interactive GraphQL Explorer

​Quick Start

​1. Authentication

​2. Explore the Schema

​3. Try Sample Queries

​Get Drops

​Get User Profile

​Create a Token

​Explorer Features

​🔍 Schema Introspection

​🧪 Query Testing

​📚 Interactive Documentation

​🔧 Request Configuration

​Schema Overview

​Root Types

​Core Types

​Drop

​Token

​User

​Advanced Features

​Variables and Fragments

​Subscriptions

​Introspection

​Tips for Using the Explorer

​1. Use Auto-Complete

​2. Navigate with Keyboard

​3. Save Your Work

​4. Test Error Handling

​API Endpoint

​Authentication

​Need Help?

Pro Tip

Interactive GraphQL Explorer

Quick Start

1. Authentication

2. Explore the Schema

3. Try Sample Queries

Get Drops

Get User Profile

Create a Token

Explorer Features

🔍 Schema Introspection

🧪 Query Testing

📚 Interactive Documentation

🔧 Request Configuration

Schema Overview

Root Types

Core Types

Drop

Token

User

Advanced Features

Variables and Fragments

Subscriptions

Introspection

Tips for Using the Explorer

1. Use Auto-Complete

2. Navigate with Keyboard

3. Save Your Work

4. Test Error Handling

API Endpoint

Authentication

Need Help?