Service Guides

Each guide covers a specific service client with code examples in Python and JavaScript, parameter references, and expected output.

#	Service	Auth	Description
1	Inverter Telemetry	`ASOBA_API_KEY`	Query historical and stream live inverter data (5-min and daily resolution)
2	OODA Terminal Alerts	`ASOBA_API_KEY`	Query and stream fault/diagnostic alerts from terminal devices
3	Partner API	`ASOBA_API_KEY`	Pre-computed JSON snapshots with ETag caching (sub-100ms)
4	Forecasting	`ASOBA_API_KEY`	Per-device and per-site solar energy forecasts
5	Freemium Forecasting	❌	No-key CSV-based solar forecasting with email verification
6	MCP Server	`ASOBA_API_KEY`	Expose all SDK tools to AI agents via the Model Context Protocol

Quick Start

# Python
from asoba import OnaClient
client = OnaClient()  # uses ASOBA_API_KEY
records = client.inverter_telemetry.get_inverter_telemetry(
    asset_id='INV-1000000054495190',
    site_id='Sibaya',
    time_range={'start': '2025-11-01T00:00:00', 'end': '2025-11-01T12:00:00'},
    resolution='5min',
    limit=100,
)

// JavaScript
const { OnaSDK } = require('@asobacloud/sdk');
const sdk = new OnaSDK();  // uses ASOBA_API_KEY

const records = await sdk.inverterTelemetry.getInverterTelemetry({
  asset_id: 'INV-1000000054495190',
  site_id: 'Sibaya',
  time_range: { start: '2025-11-01T00:00:00', end: '2025-11-01T12:00:00' },
  resolution: '5min',
  limit: 100,
});

Full Examples

Complete working examples for every service are in the SDK repository:

Python: sdk/python/examples/
JavaScript: sdk/javascript/examples/