Introduction

https://api.dropkit.co/graphql

Authorization: Bearer <api_key>

curl -X POST https://api.dropkit.co/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query GetMyDrops { myDrops { id title status claimCount } }"
  }'

{
  "data": {
    "myDrops": [
      {
        "id": "drop_abc123",
        "title": "My NFT Collection",
        "status": "ACTIVE",
        "claimCount": 42
      }
    ]
  }
}

{
  "errors": [
    {
      "message": "Drop not found",
      "locations": [{ "line": 2, "column": 3 }],
      "path": ["drop"]
    }
  ],
  "data": {
    "drop": null
  }
}

query GetDropDetails {
  drop(id: "drop_abc123") {
    id
    title
    claimedAmount
    maxAmount
    claimRate
    token {
      name
      symbol
      totalSupply
    }
    claims {
      id
      amount
      user {
        username
      }
    }
  }
}

mutation CreateToken {
  createToken(
    input: {
      name: "My Token"
      symbol: "MTK"
      supply: 1000000
      description: "My custom token"
    }
  ) {
    id
    name
    symbol
    status
    address
  }
}

mutation CreateDrop {
  createDrop(
    input: {
      title: "My NFT Drop"
      type: TOKEN
      maxAmount: "100000"
      tokenAmount: "100"
      existingTokenId: "token_xyz789"
    }
  ) {
    id
    title
    status
    shortcode
  }
}

query CheckEligibility {
  checkGatingEligibility(
    input: { dropId: "drop_abc123", walletAddress: "0x123..." }
  ) {
    eligible
    reason
    missingRequirements
  }
}

mutation CreatePaymentIntent {
  createPaymentIntent(
    input: {
      dropId: "drop_abc123"
      walletAddress: "0x123..."
      paymentMethod: "sui"
      quantity: 2
    }
  ) {
    id
    intentId
    status
    amount
    paymentUrl
  }
}

query LiveDropStats {
  drop(id: "drop_abc123") {
    claimedAmount # Live blockchain data
    maxAmount # Live blockchain data
    remainingBalance # Computed field
    tokenBalance # Live token balance
    claimRate # Computed percentage
    isActive # Live status
  }
}