API Documentation

Integrate Nova-X network and security utilities into your own applications, bots, and automation workflows. Open, unauthenticated, and CORS-enabled.

Response Envelope

Standard Response Envelope

All Nova-X API endpoints adhere to a standardized JSON envelope for both successful responses and errors.

Success Schema (HTTP 200)

json

{
  "success": true,
  "data": { ... },
  "meta": { ... } // optional
}

Error Schema (HTTP 4xx / 5xx)

json

{
  "success": false,
  "error": {
    "code": "INVALID_DOMAIN",
    "message": "Human readable explanation"
  }
}

Rate Limiting

International Rate Limit Standard (IETF RFC 6585)

All endpoints enforce 60 requests per minute per client IP. Every response returns standard RFC rate limit headers:

IETF Headers

RateLimit-Limit: 60

RateLimit-Remaining: 59

RateLimit-Reset: 60

RateLimit-Policy: 60;w=60

Legacy Headers & HTTP 429

X-RateLimit-Limit: 60

X-RateLimit-Remaining: 59

X-RateLimit-Reset: 1731000000

Retry-After: 60 (on 429)

HTTP 429 Too Many Requests

json

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Limit is 60 requests per 60 seconds. Retry in 42 seconds."
  }
}

API Documentation

Available Endpoints