5-Minute Quickstart

Ready to start building with DRIP? Let’s get you up and running in 5 minutes! 🚀

TL;DR - Just Want to Code?

# 1. Get your API key from Admin > Developer > Project API
# 2. Replace YOUR_API_KEY and YOUR_REALM_ID below
# 3. Run this command

curl -X GET "https://api.drip.re/api/v1/realms/YOUR_REALM_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

// npm install node-fetch
const response = await fetch('https://api.drip.re/api/v1/realms/YOUR_REALM_ID', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
console.log(await response.json());

# pip install requests
import requests
r = requests.get('https://api.drip.re/api/v1/realms/YOUR_REALM_ID', 
                 headers={'Authorization': 'Bearer YOUR_API_KEY'})
print(r.json())

Step-by-Step (For Real This Time)

1. Get Your API Key (30 seconds)

Open DRIP Dashboard

Go to app.drip.re and log in

Navigate to Developer Portal

Click Admin → Developer in the sidebar

Create API Client

Click Project API tab
Click Create API Client
Give it a name like “My First App”
Select some scopes (start with realm:read and members:read)
Click Create

Copy Your Keys

Copy both the Client ID and Client Secret (you’ll need the secret)

2. Find Your Realm (Project) ID (15 seconds)

Your Realm ID is displayed in the dashboard header when you select your project:

Select Your Project

In the DRIP dashboard, make sure your project is selected from the project switcher

Copy Realm ID

Look at the dashboard header - your Realm ID is displayed there and can be copied directly

3. Make Your First Call (1 minute)

JavaScript
Python
cURL

const DRIP_API_KEY = 'your_client_secret_here';
const REALM_ID = 'your_realm_id_here';

async function getDripData() {
  try {
    // Get your realm info
    const realm = await fetch(`https://api.drip.re/api/v1/realms/${REALM_ID}`, {
      headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
    }).then(r => r.json());
    
    console.log('🎉 Your realm:', realm.name);
    
    // Get some members
    const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=drip-id&values=all`, {
      headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
    }).then(r => r.json());
    
    console.log('👥 Member count:', members.data?.length || 0);
    
  } catch (error) {
    console.error('❌ Error:', error.message);
  }
}

getDripData();

import requests

DRIP_API_KEY = 'your_client_secret_here'
REALM_ID = 'your_realm_id_here'

headers = {'Authorization': f'Bearer {DRIP_API_KEY}'}

try:
    # Get your realm info
    realm = requests.get(f'https://api.drip.re/api/v1/realms/{REALM_ID}', headers=headers).json()
    print(f'🎉 Your realm: {realm["name"]}')
    
    # Get some members  
    members = requests.get(f'https://api.drip.re/api/v1/realm/{REALM_ID}/members/search?type=drip-id&values=all', headers=headers).json()
    print(f'👥 Member count: {len(members.get("data", []))}')
    
except Exception as error:
    print(f'❌ Error: {error}')

# Set your variables
DRIP_API_KEY="your_client_secret_here"
REALM_ID="your_realm_id_here"

# Get realm info
echo "🎉 Your realm:"
curl -s "https://api.drip.re/api/v1/realms/$REALM_ID" \
  -H "Authorization: Bearer $DRIP_API_KEY" | jq '.name'

# Get member count
echo "👥 Member count:"
curl -s "https://api.drip.re/api/v1/realm/$REALM_ID/members/search?type=drip-id&values=all" \
  -H "Authorization: Bearer $DRIP_API_KEY" | jq '.data | length'

What Just Happened? 🤔

You just:

✅ Authenticated with the DRIP API
✅ Retrieved your realm information
✅ Searched for members in your community

Not bad for 5 minutes! 🎉

What Can You Do Next?

Award Points to Members

Give your community members some points for being awesome

Search for Specific Members

Find members by Discord ID, wallet address, or username

Build a Simple Dashboard

Create your first DRIP-powered app

Member Management

Search, update, and manage community members effectively

Quick Examples for Vibe Coders

Award Points to a Member

// Find a member first
const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=username&values=cool_member`, {
  headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
}).then(r => r.json());

if (members.data?.length > 0) {
  const memberId = members.data[0].id;
  
  // Give them 100 points
  const result = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/${memberId}/point-balance`, {
    method: 'PATCH',
    headers: { 
      'Authorization': `Bearer ${DRIP_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ tokens: 100 })
  }).then(r => r.json());
  
  console.log('💰 Points awarded!', result);
}

import requests

# Find a member
members = requests.get(
    f'https://api.drip.re/api/v1/realm/{REALM_ID}/members/search?type=username&values=cool_member',
    headers={'Authorization': f'Bearer {DRIP_API_KEY}'}
).json()

if members.get('data'):
    member_id = members['data'][0]['id']
    
    # Award 100 points
    result = requests.patch(
        f'https://api.drip.re/api/v1/realm/{REALM_ID}/members/{member_id}/point-balance',
        headers={'Authorization': f'Bearer {DRIP_API_KEY}', 'Content-Type': 'application/json'},
        json={'tokens': 100}
    ).json()
    
    print('💰 Points awarded!', result)

Search Members by Discord ID

const discordId = '123456789012345678'; // Their Discord user ID

const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=discord-id&values=${discordId}`, {
  headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
}).then(r => r.json());

if (members.data?.length > 0) {
  const member = members.data[0];
  console.log(`Found: ${member.displayName} with ${member.pointBalances[0]?.balance || 0} points`);
} else {
  console.log('Member not found 😢');
}

wallet_address = '0x742d35Cc6634C0532925a3b8D23'

members = requests.get(
    f'https://api.drip.re/api/v1/realm/{REALM_ID}/members/search?type=wallet&values={wallet_address}',
    headers={'Authorization': f'Bearer {DRIP_API_KEY}'}
).json()

if members.get('data'):
    member = members['data'][0]
    points = member['pointBalances'][0]['balance'] if member['pointBalances'] else 0
    print(f"Found: {member['displayName']} with {points} points")
else:
    print('Member not found 😢')

Common “Oops” Moments 🤦‍♂️

❌ 401 Unauthorized

Problem: Your API key is wrong or missingFix: Double-check you’re using the Client Secret (not Client ID) from the developer portal

# Wrong ❌
Authorization: Bearer your_client_id_here

# Right ✅  
Authorization: Bearer your_client_secret_here

❌ 403 Forbidden

Problem: Your API client doesn’t have the right scopesFix: Go back to Admin > Developer > Project API and add more scopes to your clientCommon scopes you might need:

realm:read - Read realm info
members:read - Read member data
members:write - Update member points
points:write - Award/deduct points

❌ 404 Not Found

Problem: Wrong Realm ID or member doesn’t existFix: Check your realm ID in the dashboard URL. For members, try searching first before updating.

❌ 429 Too Many Requests

Problem: You’re making requests too fastFix: Add a small delay between requests or use batch endpoints

// Add delay
await new Promise(resolve => setTimeout(resolve, 100));

You’re Ready! 🎯

That’s it! You now know enough to be dangerous with the DRIP API. Here’s what to explore next:

Build Your First App

Create a simple DRIP-powered application

Learn the Fundamentals

Understand DRIP’s data model and concepts

See More Examples

Copy-paste code for common tasks

Pro tip: Join our Discord community for help, tips, and to show off what you’re building! 🚀

Overview

Developer Guide

Apps

Drip Academy

FAQ

Links

5-Minute Quickstart

TL;DR - Just Want to Code?

Step-by-Step (For Real This Time)

1. Get Your API Key (30 seconds)

2. Find Your Realm (Project) ID (15 seconds)

3. Make Your First Call (1 minute)

What Just Happened? 🤔

What Can You Do Next?

Award Points to Members

Search for Specific Members

Build a Simple Dashboard

Member Management

Quick Examples for Vibe Coders

Award Points to a Member

Search Members by Discord ID

Common “Oops” Moments 🤦‍♂️

You’re Ready! 🎯

Build Your First App

Learn the Fundamentals

See More Examples

​TL;DR - Just Want to Code?

​Step-by-Step (For Real This Time)

​1. Get Your API Key (30 seconds)

​2. Find Your Realm (Project) ID (15 seconds)

​3. Make Your First Call (1 minute)

​What Just Happened? 🤔

​What Can You Do Next?

Award Points to Members

Search for Specific Members

Build a Simple Dashboard

Member Management

​Quick Examples for Vibe Coders

​Award Points to a Member

​Search Members by Discord ID

​Common “Oops” Moments 🤦‍♂️

​You’re Ready! 🎯

Build Your First App

Learn the Fundamentals

See More Examples

TL;DR - Just Want to Code?

Step-by-Step (For Real This Time)

1. Get Your API Key (30 seconds)

2. Find Your Realm (Project) ID (15 seconds)

3. Make Your First Call (1 minute)

What Just Happened? 🤔

What Can You Do Next?

Quick Examples for Vibe Coders

Award Points to a Member

Search Members by Discord ID

Common “Oops” Moments 🤦‍♂️

You’re Ready! 🎯