amanoki

Python client for the Amanoki electricity-market regime API. Covers JEPX today; ERCOT / PJM / CAISO / AEMO / NYISO are catalogued and will land as adapters arrive.

pip install amanoki

Quick start

from amanoki import Client

c = Client()                     # public endpoints, no auth
r = c.get_regime("jepx", "tokyo")
print(r.regime, r.price, r.price_unit)   # normal 16.75 kWh

s = c.spike_probability("jepx", "tokyo")
for cell in s.cells:
    print(cell.threshold, cell.horizon_min, cell.p, cell.base_rate)

All methods also exist on AsyncClient:

import asyncio
from amanoki import AsyncClient

async def main():
    async with AsyncClient() as c:
        status = await c.status()
        print(status.markets_with_data, status.latest_bar_ms)

asyncio.run(main())

Endpoints covered

Error handling

All non-2xx responses raise a typed subclass of AmanokiError:

from amanoki import Client, NotFoundError, RateLimitError

try:
    c.get_regime("jepx", "okinawa")
except NotFoundError:
    ...
except RateLimitError as e:
    time.sleep(e.retry_after or 30)

Authentication

Client(api_key=...) sets Authorization: Bearer <key>. Public endpoints don't require a key. Paid-tier endpoints are planned — the hook is in place so code written today keeps working when they open.

Versioning

Matches the API surface, not the service version. Breaking client changes bump the major.