Asoba Ona Documentation
Home Insights Contact Us

Quickstart

Query live inverter telemetry in three steps using the Ona SDK.

Step 1: Install

Python:

git clone https://github.com/AsobaCloud/sdk.git
cd sdk/python && pip3 install -e .

JavaScript:

git clone https://github.com/AsobaCloud/sdk.git
cd sdk/javascript && npm install

Step 2: Configure

export INVERTER_TELEMETRY_ENDPOINT=https://af5jy5ob3e.execute-api.af-south-1.amazonaws.com/prod
export INVERTER_TELEMETRY_API_KEY=<your_api_key>

Contact [email protected] to get an API key.

Step 3: Query

Python:

from ona_platform import OnaClient
from ona_platform.models.telemetry import TimeRange

client = OnaClient()

records = client.inverter_telemetry.get_inverter_telemetry(
    asset_id="INV-1000000054495190",
    site_id="Sibaya",
    time_range=TimeRange(start="2025-11-01T00:00:00", end="2025-11-01T12:00:00"),
    limit=10,
)

for r in records:
    print(f"{r.timestamp}: {r.power} kW")

JavaScript:

const { OnaSDK } = require('./src/index');

const sdk = new OnaSDK({
  endpoints: { inverterTelemetry: process.env.INVERTER_TELEMETRY_ENDPOINT },
  inverterTelemetryApiKey: process.env.INVERTER_TELEMETRY_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' },
  limit: 10,
});

records.forEach(r => console.log(`${r.timestamp}: ${r.power} kW`));

Next steps