Skip to main content

API Reference

Welcome to the Nefarious Labs API reference. Here you’ll find detailed documentation for all available endpoints.

Base URL

https://api.nefariouslabs.dev

Authentication

All API requests require an API key. Include it in the request header:
X-API-Key: your-api-key
Never expose your API key in client-side code. Always make API calls from your backend.

Rate Limiting

Rate limits are applied per API key. When you exceed your rate limit, you’ll receive a 429 Too Many Requests response. Response headers include:
  • X-RateLimit-Limit: Your rate limit
  • X-RateLimit-Remaining: Remaining requests
  • X-RateLimit-Reset: Unix timestamp when the limit resets

Error Handling

All errors follow a consistent format:
{
  "error": {
    "code": "INVALID_WALLET",
    "message": "The provided wallet address is invalid",
    "details": {}
  }
}

Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Invalid or missing API key
RATE_LIMITED429Rate limit exceeded
INVALID_PARAMS400Invalid request parameters
NOT_FOUND404Resource not found
INTERNAL_ERROR500Internal server error

SDKs

TypeScript SDK

Official TypeScript/JavaScript SDK

Python SDK

Official Python SDK