API Documentation

Getting Started

The Eagle Virtual API provides programmatic access to our stablecoin blacklist database. Check any address across 14+ blockchains for blacklist status, proximity risk, and historical events.

All API requests require authentication via API key. Responses are returned in JSON format.

Authentication

Include your API key in the Authorization header with every request:

Authorization: Bearer YOUR_API_KEY

To obtain an API key, sign in to your account and navigate to Settings → API Keys.

Check Address

Check if an address is blacklisted and get risk assessment.

curl -X GET "https://api.eaglevirtual.com/address/ethereum/0x1234...abcd" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": "0x1234...abcd",
  "chain": "ethereum",
  "is_blacklisted": false,
  "proximity": {
    "hops": 2,
    "risk_score": 0.15,
    "nearest_blacklisted": "0xdead...beef"
  },
  "tokens_affected": [],
  "checked_at": "2024-12-11T10:30:00Z"
}

Get Blacklist Events

Retrieve recent blacklist events across all chains or for a specific token.

{
  "events": [
    {
      "id": "evt_abc123",
      "type": "blacklist_add",
      "chain": "ethereum",
      "token": "USDT",
      "address": "0xdead...beef",
      "block_number": 18500000,
      "timestamp": "2024-12-10T15:42:00Z"
    }
  ],
  "total": 1247,
  "has_more": true
}

Supported Chains

The API currently supports the following blockchains:

Additional chains available. Contact us for the full list.

Rate Limits

API rate limits depend on your subscription plan:

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1702300800

Error Handling

The API uses standard HTTP status codes and returns errors in a consistent format:

{
  "error": {
    "code": "invalid_address",
    "message": "The provided address is not valid for the specified chain"
  }
}