API Documentation

Integrate DNSUSD alias resolution into your application

Manage API Keys

Getting Started

To use the DNSUSD API, you'll need an API key. Create one from the API Keys page.

Include your API key in the Authorization header as a Bearer token.

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer dnsusd_live_...

Endpoints

GET/api/v1/resolve

Resolve a single alias to cryptocurrency addresses.

Query Parameters

  • alias (required) - The alias to resolve (e.g., example.com, user.eth)

Example Request

curl -X GET "https://dnsusd.app/api/v1/resolve?alias=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "alias": "example.com",
    "results": [
      {
        "chain": "ETH",
        "address": "0x1234...",
        "source": "dns",
        "confidence": 0.95
      }
    ],
    "resolved_at": "2025-01-14T12:00:00Z",
    "response_time_ms": 245
  }
}
POST/api/v1/resolve/batch

Resolve multiple aliases in a single request (max 100).

Request Body

{
  "aliases": ["example.com", "user.eth", "domain.crypto"]
}

Example Response

{
  "success": true,
  "data": {
    "total": 3,
    "results": [
      {
        "alias": "example.com",
        "success": true,
        "results": [...]
      },
      ...
    ],
    "resolved_at": "2025-01-14T12:00:00Z",
    "response_time_ms": 512
  }
}
GET/api/v1/aliases/:alias/trust

Get trust score and verification status for an alias.

Example Response

{
  "success": true,
  "data": {
    "alias": "example.com",
    "trust_score": 85,
    "trust_level": "high",
    "verification_status": "verified",
    "last_verified_at": "2025-01-14T10:00:00Z",
    "response_time_ms": 123
  }
}

Rate Limits

Rate limits vary by tier:

  • Free10 requests/minute, 100/hour, 1,000/day
  • Pro100 requests/minute, 1,000/hour, 10,000/day
  • EnterpriseCustom limits

Rate limit information is included in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Error Codes

  • 400 - Bad Request (missing or invalid parameters)
  • 401 - Unauthorized (invalid or missing API key)
  • 404 - Not Found (alias not found)
  • 429 - Too Many Requests (rate limit exceeded)
  • 500 - Internal Server Error