NETTS / DOCUMENTATION

# NETTS API Documentation

Welcome to the NETTS API documentation. Our API provides programmatic access to NETTS' services, allowing you to integrate energy rental and management functionality into your own applications.

# Overview

NETTS offers a RESTful API that communicates via HTTPS and returns JSON-formatted responses. All requests require authentication using an API key.

Our API allows you to:

  • Check current energy prices
  • Get information about your account
  • Access your delegation history
  • View your balance and usage statistics

# Base URL

All API endpoints use the following base URL:

https://netts.io/apiv2/

# Available Endpoints

Endpoint Description
/prices Get current energy prices for different time periods
/userinfo Get account information and statistics

# Rate Limits

To ensure fair usage and system stability, the API has rate limits in place. Currently, the limit is 2 requests per second per API key.

If you exceed this limit, the API will return a 429 Too Many Requests status code.

# Response Format

All API responses are in JSON format and include a status field that indicates whether the request was successful or not.

# Success Response Example

{
  "status": "success",
  "timestamp": "2025-04-23 12:34:56",
  "data": {
    // Response data here
  }
}

# Error Response Example

{
  "status": "error",
  "code": 401,
  "message": "Invalid API key or IP not in whitelist"
}

# Getting Started

  1. Obtain an API key
  2. Authenticate your requests
  3. Explore our API endpoints
  4. Check out our example code to get started quickly

← Authentication →