API Reference

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

Base URL

bash
https://api.nefariouslabs.dev

Authentication

All API requests require an API key. Include it in the request header:

bash
X-API-Key: your-api-key
Warning: 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:

json
{
"error": {
"code": "INVALID_WALLET",
"message": "The provided wallet address is invalid",
"details": {}
}
}

Common Error Codes

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

SDKs

Endpoints

Ready to start building?

Get your API key in seconds. Free tier included.

Get Started — free

No credit card required