Welcome to Nolano API Platform

The Nolano API delivers enterprise-grade Time Series Foundation Models for forecasting and anomaly detection, with secure authentication, robust key management, and AWS-powered reliability, security, and scalability.

Quick Start

Get up and running with the Nolano API in under 5 minutes:
1

Get Your API Key

Sign up at app.nolano.ai and generate your API key from the dashboard.
2

Test Authentication

Verify your API key is working:
curl -H "Authorization: Bearer your_api_key_here" https://api.nolano.ai/verify
3

Make Your First Forecast

Use the /forecast endpoint to predict future values:
curl -X POST https://api.nolano.ai/forecast \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"series":[{"timestamps":["2023-01-01T00:00:00","2023-01-02T00:00:00"],"values":[100,102]}],"forecast_horizon":5,"data_frequency":"Daily","forecast_frequency":"Daily"}'

Authentication

All API endpoints require authentication using API keys in the Authorization header.

API Key Format

Authorization: Bearer ak_[64_character_hex_string]
API keys always start with ak_ followed by a 64-character hexadecimal string.

Verify Authentication

Test your API key with the verification endpoint:
curl -X GET "https://api.nolano.ai/verify" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"
Success Response:
{
  "success": true,
  "message": "API key is valid and working correctly",
  "timestamp": "2025-01-17T00:20:24.435Z",
  "apiKey": {
    "permissions": ["read"]
  },
  "rateLimit": {
    "limit": "1000",
    "remaining": "999",
    "resetTime": "1755044460000"
  }
}

Rate Limits

API requests are limited based on your API key’s permission level:
Permission LevelRequests/MinRequests/HourRequests/Day
Read Only5050010,000
Read/Write1001,00050,000
Admin2002,000100,000
Full Access5005,000250,000

Rate Limit Headers

Every API response includes rate limit information:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1755044460

Handling Rate Limits

When you exceed your rate limit, you’ll receive a 429 Too Many Requests response:
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "API rate limit exceeded",
    "details": {
      "limit": 1000,
      "reset_time": "2025-01-17T01:00:00Z"
    }
  }
}
Implement exponential backoff when handling rate limit errors to avoid repeated failures.

API Key Security

  • Secure Storage: API keys are hashed using SHA-256 before storage
  • Usage Tracking: All API calls are logged with usage statistics
  • Instant Revocation: Immediately revoke compromised keys through the dashboard
  • Environment Variables: Store keys in environment variables, never in source code
Never expose API keys in client-side code or public repositories. Keys should only be used in secure server-side environments.

Contact Us

Need Support?

Have questions about the API or need technical assistance? Our team is here to help!Email: hello@nolano.aiWe typically respond within 24 hours during business days.