API Documentation

Integrate multi-chain reputation data into your applications

What can I build with the Hunger4Crypto API?

Access real-time reputation scores, badge data, and activity metrics for any wallet across Ethereum, Solana, and Algorand. Perfect for token-gating, leaderboards, Discord bots, and community dashboards.

The API is RESTful, requires no authentication for public endpoints, and returns JSON responses. Rate limit: 100 requests/minute for public endpoints, 1000 requests/minute with API key.

Get API KeyTry Examples

Base URL

https://api.hunger4crypto.com/v1
GET/reputation/:address

Get Reputation Score

Retrieve the reputation score and tier for a wallet address

Parameters

address(string)* - Wallet address (Ethereum, Solana, or Algorand)
chain(string) - Optional: eth, sol, algo. Auto-detected if omitted.

Response Example

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "chain": "ethereum",
  "score": 4850,
  "tier": "Shark",
  "rank": 127,
  "totalUsers": 1000,
  "badges": [
    "Early Adopter",
    "DeFi Master",
    "Community Leader"
  ],
  "lastUpdated": "2025-12-15T14:30:00Z"
}
GET/badges/:address

Get User Badges

Retrieve all badges earned by a wallet address

Parameters

address(string)* - Wallet address

Response Example

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "badges": [
    {
      "id": "early-adopter",
      "name": "Early Adopter",
      "description": "Joined in the first month",
      "tier": "Legendary",
      "earnedAt": "2024-01-15T00:00:00Z",
      "imageUrl": "https://hunger4crypto.com/badges/early-adopter.png",
      "soulbound": true
    }
  ],
  "total": 12
}
GET/leaderboard

Get Leaderboard

Retrieve top users by reputation score

Parameters

limit(number) - Number of users to return (default: 100, max: 500)
offset(number) - Pagination offset (default: 0)
chain(string) - Filter by chain: eth, sol, algo, or all (default: all)

Response Example

{
  "leaderboard": [
    {
      "rank": 1,
      "address": "0x1234...5678",
      "displayName": "CryptoWhale.eth",
      "score": 9200,
      "tier": "Titan",
      "badges": 24
    },
    {
      "rank": 2,
      "address": "Abc123...xyz",
      "displayName": "SolanaShark",
      "score": 12850,
      "tier": "Titan",
      "badges": 18
    }
  ],
  "total": 1000,
  "limit": 100,
  "offset": 0
}
GET/activity/:address

Get Activity Feed

Retrieve recent activity for a wallet address

Parameters

address(string)* - Wallet address
limit(number) - Number of activities (default: 50, max: 200)

Response Example

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "activities": [
    {
      "id": "act_123abc",
      "type": "badge_earned",
      "description": "Earned \"DeFi Master\" badge",
      "points": 500,
      "timestamp": "2025-12-14T18:20:00Z"
    },
    {
      "id": "act_456def",
      "type": "governance_vote",
      "description": "Voted on proposal #42",
      "points": 20,
      "timestamp": "2025-12-14T12:15:00Z"
    }
  ],
  "total": 1847
}
GET/stats/global

Get Global Statistics

Retrieve platform-wide statistics

Response Example

{
  "totalUsers": 1000,
  "totalBadgesIssued": 3500,
  "chains": {
    "ethereum": {
      "users": 600
    },
    "solana": {
      "users": 300
    },
    "algorand": {
      "users": 100
    }
  },
  "averageScore": 250,
  "topTier": {
    "titan": 5,
    "whale": 20,
    "shark": 80,
    "dolphin": 300,
    "shrimp": 595
  }
}

Code Examples

JavaScript / Node.js

// Fetch reputation score
const response = await fetch(
  'https://api.hunger4crypto.com/v1/reputation/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
);
const data = await response.json();

console.log(`Score: ${data.score}, Tier: ${data.tier}`);
// Output: Score: 4850, Tier: Shark

Python

import requests

# Fetch badges for address
response = requests.get(
    'https://api.hunger4crypto.com/v1/badges/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
)
data = response.json()

print(f"Total badges: {data['total']}")

cURL

# Get leaderboard top 10
curl -X GET "https://api.hunger4crypto.com/v1/leaderboard?limit=10" \
  -H "Accept: application/json"

âš¡ Rate Limits

Public Endpoints
100 requests per minute
With API Key
1,000 requests per minute
Request API Key

Error Codes

400Bad Request - Invalid address format
404Not Found - Address not found in system
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Please try again later

Ready to Build?

Get your free API key and start integrating multi-chain reputation into your project today

Request Free API Key