API Reference

Airdrop Guard API Docs

Query reviewed crypto project scores via a simple REST API. Authenticate with your API key, respect rate limits, and parse JSON responses.

Get API Key Dashboard

1Base URL

https://uxowlueodplfhxmjjqlv.supabase.co/functions/v1/api-v1

2Authentication

Bearer Token

Include your API key in every request as an Authorization header.

Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3Rate Limits & Plans

Free

100 / month

score, risk_level

Popular

Pro

10,000 / month

score, risk, summary, breakdowns

Business

100,000 / month

All fields + history

When you exceed your limit the API returns 429 Too Many Requests. Limits reset on the 1st of each month.

4Endpoints

GET/projects

FreeProBusiness

Returns a list of all active reviewed projects.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://uxowlueodplfhxmjjqlv.supabase.co/functions/v1/api-v1/projects"

Response

{
  "data": [
    {
      "project_name": "Ethereum Layer2 Protocol",
      "slug": "eth-layer2",
      "score": 87,
      "risk_level": "Low",
      "status": "active"
    },
    {
      "project_name": "DeFi Yield Aggregator",
      "slug": "defi-yield",
      "score": 64,
      "risk_level": "Medium",
      "status": "active"
    }
  ],
  "count": 2,
  "plan": "free"
}

GET/projects/:slug

ProBusiness

Returns full details for a single project by its slug.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://uxowlueodplfhxmjjqlv.supabase.co/functions/v1/api-v1/projects/eth-layer2"

Response

{
  "data": {
    "project_name": "Ethereum Layer2 Protocol",
    "slug": "eth-layer2",
    "score": 87,
    "risk_level": "Low",
    "summary": "A well-audited Layer 2 scaling solution with strong team credibility and active GitHub contributions. Token distribution is fair with reasonable vesting schedules.",
    "positives": [
      "Audited by Certik",
      "Active GitHub (230+ commits last month)",
      "Transparent team"
    ],
    "concerns": [
      "Relatively new project",
      "Concentrated token allocation"
    ],
    "github_score": 91,
    "team_score": 85,
    "security_score": 88,
    "community_score": 79,
    "website_score": 82,
    "tokenomics_score": 74,
    "status": "active"
  },
  "plan": "pro"
}

GET/score/:slug

FreeProBusiness

Returns just the score data for a project.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://uxowlueodplfhxmjjqlv.supabase.co/functions/v1/api-v1/score/eth-layer2"

Response

{
  "data": {
    "project_name": "Ethereum Layer2 Protocol",
    "slug": "eth-layer2",
    "score": 87,
    "risk_level": "Low",
    "summary": "A well-audited Layer 2 scaling solution with strong team credibility and active GitHub contributions. Token distribution is fair with reasonable vesting schedules.",
    "positives": [
      "Audited by Certik",
      "Active GitHub (230+ commits last month)",
      "Transparent team"
    ],
    "concerns": [
      "Relatively new project",
      "Concentrated token allocation"
    ],
    "github_score": 91,
    "team_score": 85,
    "security_score": 88,
    "community_score": 79,
    "website_score": 82,
    "tokenomics_score": 74,
    "status": "active",
    "website_url": "https://eth-layer2.example.com",
    "github_url": "https://github.com/eth-layer2",
    "reviewed_by_human": true,
    "last_reviewed_at": "2026-06-08T14:22:00Z",
    "created_at": "2026-05-01T10:00:00Z",
    "updated_at": "2026-06-08T14:22:00Z"
  },
  "plan": "business"
}

5Error Codes

Code	Meaning
401	Missing, invalid, or revoked API key
404	Project slug not found
405	Method not allowed (only GET is supported)
429	Monthly request limit exceeded — upgrade your plan
500	Internal server error — contact support

Ready to integrate?

View Pricing Go to Dashboard