API Reference

CoinRewards exposes a REST API for integrating with external services.

Base URL

https://coinrewards.fun/api

Endpoints

GET/api/tokens

List all tokens with CoinRewards enabled

GET/api/token/[mint]

Get details for a specific token

GET/api/leaderboard

Get token rankings by reward pool size

GET/api/stats

Get overall platform statistics

GET/api/events/stream

Server-Sent Events stream for real-time updates

GET/api/projection

Get reward projections for a wallet

Example

# Get all tokens
curl https://coinrewards.fun/api/tokens

# Response
{
  "tokens": [
    {
      "mint": "...",
      "symbol": "PUMP",
      "name": "PumpToken",
      "totalDeposited": 125.5,
      "totalDistributed": 100.2,
      "holders": 1234
    }
  ]
}

Rate Limits

• Public endpoints: 100 requests/minute
• Event stream: 1 connection per IP
• Webhook callbacks: No rate limit

How It Works Architecture