API Reference

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.

Base URL

https://api.nolano.ai

Supported Models

4+ Time Series Foundation Models

Quick Start

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

Get Your API Key

Test Authentication

Verify your API key is working:

curl -H "Authorization: Bearer your_api_key_here" https://api.nolano.ai/verify

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"

import requests

response = requests.get(
    "https://api.nolano.ai/verify",
    headers={
        "Authorization": "Bearer your_api_key_here",
        "Content-Type": "application/json"
    }
)
print(response.json())

const response = await fetch('https://api.nolano.ai/verify', {
  headers: {
    'Authorization': 'Bearer your_api_key_here',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
console.log(data);

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 Level	Requests/Min	Requests/Hour	Requests/Day
Read Only	50	500	10,000
Read/Write	100	1,000	50,000
Admin	200	2,000	100,000
Full Access	500	5,000	250,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.

Overview

Authentication

Forecasting

Welcome to Nolano API Platform

Base URL

Supported Models

Quick Start

Authentication

API Key Format

Verify Authentication

Rate Limits

Rate Limit Headers

Handling Rate Limits

API Key Security

Contact Us

Need Support?

​Welcome to Nolano API Platform

Base URL

Supported Models

​Quick Start

​Authentication

​API Key Format

​Verify Authentication

​Rate Limits

​Rate Limit Headers

​Handling Rate Limits

​API Key Security

​Contact Us

Need Support?

Welcome to Nolano API Platform

Quick Start

Authentication

API Key Format

Verify Authentication

Rate Limits

Rate Limit Headers

Handling Rate Limits

API Key Security

Contact Us