API Documentation

FaucetHub API

RESTful API for accessing testnet faucet data across 8+ blockchain networks

Base URL

Primary Domain:

https://faucethub.elpeef.com/api

Alternative Domain:

https://relationship-government-307.app.ohara.ai/api
Quick Start
Get started with the FaucetHub API in seconds
// Fetch all faucets
const response = await fetch('https://faucethub.elpeef.com/api/faucets');
const { data, count } = await response.json();

console.log(`Found ${count} faucets`);
data.forEach(faucet => {
  console.log(`${faucet.name} - ${faucet.network}`);
});

Endpoints

GET/faucets
Get all available faucets

Parameters

network
string

Filter by network (e.g., base-sepolia)

q
string

Search query for faucet name/description

action
string

Special actions: stats, networks

Response

{
  "success": true,
  "data": [
    {
      "id": "ponzifun-base",
      "name": "Ponzifun Base Faucet",
      "url": "https://faucet.ponzifun.dev/",
      "network": "base-sepolia",
      "chain": "Base Sepolia",
      "tokens": [
        "ETH"
      ],
      "cooldown": "48 hours",
      "requirements": [
        "No signup required"
      ],
      "verified": true,
      "recommended": true,
      "rating": 4.8,
      "responseTime": 250
    }
  ],
  "count": 22
}

Examples

// Get all faucets
const response = await fetch('https://faucethub.elpeef.com/api/faucets');
const data = await response.json();
console.log(data.data); // Array of 22+ faucets
GET/faucets?network=base-sepolia
Filter faucets by network

Response

{
  "success": true,
  "data": [],
  "count": 6
}

Examples

// Get Base Sepolia faucets only
const response = await fetch('https://faucethub.elpeef.com/api/faucets?network=base-sepolia');
const baseFaucets = await response.json();
GET/faucets?q=alchemy
Search faucets by name or description

Response

{
  "success": true,
  "data": [],
  "count": 1
}

Examples

// Search for specific faucet
const response = await fetch('https://faucethub.elpeef.com/api/faucets?q=alchemy');
const results = await response.json();
GET/faucets?action=stats
Get statistics about all faucets

Response

{
  "success": true,
  "data": {
    "totalFaucets": 22,
    "totalNetworks": 8,
    "averageCooldown": "24 hours",
    "verifiedFaucets": 22
  }
}

Examples

// Get faucet statistics
const response = await fetch('https://faucethub.elpeef.com/api/faucets?action=stats');
const stats = await response.json();
console.log(stats.data.totalFaucets); // 22
GET/faucets?action=networks
Get list of all supported networks

Response

{
  "success": true,
  "data": [
    "base-sepolia",
    "ethereum-sepolia",
    "optimism-sepolia",
    "arbitrum-sepolia",
    "polygon-amoy",
    "avalanche-fuji",
    "bsc-testnet",
    "scroll-sepolia"
  ]
}

Examples

// Get all networks
const response = await fetch('https://faucethub.elpeef.com/api/faucets?action=networks');
const networks = await response.json();
GET/health
Check API health status

Response

{
  "status": "healthy",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Examples

// Health check
const response = await fetch('https://faucethub.elpeef.com/api/health');
const health = await response.json();
Supported Networks
FaucetHub currently supports 8 blockchain testnets
base-sepolia
ethereum-sepolia
optimism-sepolia
arbitrum-sepolia
polygon-amoy
avalanche-fuji
bsc-testnet
scroll-sepolia

Use Cases

Discord Bot
Fetch faucet links automatically for your Discord server members
CLI Tool
Build a command-line tool to find and access testnet faucets
Browser Extension
Create an extension for quick access to faucet information
Mobile App
Develop a native mobile app for testnet token management
Rate Limits
Fair usage policy for the FaucetHub API

✓ No Authentication Required

The API is completely free and open - no API keys needed

⚡ No Rate Limits (Currently)

Fair usage expected - excessive requests may be throttled in the future

🔄 Real-time Updates

Faucet data is updated regularly with new additions and removals

Need Help?
Have questions or suggestions for the API?