credits

Query the organization's prepaid credit balance and walk the ledger of every credit movement (grants, debits, topups, refunds, adjustments). Exposed via speko.credits.

Balances are returned in USD. Ledger amounts still use micro-USD strings because ledger entries are signed accounting units.

get_balance

Speko.credits.get_balance() -> OrganizationBalance

await AsyncSpeko.credits.get_balance() -> OrganizationBalance

Returns the current balance for the caller's organization.

balance = speko.credits.get_balance()
if balance.balance_usd < 0.5:
    print("Top up before running long sessions.")

OrganizationBalance

get_ledger

Speko.credits.get_ledger(
    *,
    limit: int | None = None,
    cursor: str | None = None,
) -> CreditLedgerPage

await AsyncSpeko.credits.get_ledger(
    *,
    limit: int | None = None,
    cursor: str | None = None,
) -> CreditLedgerPage

Most-recent-first page of credit movements. Pass next_cursor from one response back in as cursor to fetch the next page; next_cursor is None means the history is exhausted.

page = speko.credits.get_ledger(limit=50)
while True:
    for entry in page.entries:
        print(entry.created_at, entry.kind, entry.amount_micro_usd, entry.provider)
    if page.next_cursor is None:
        break
    page = speko.credits.get_ledger(limit=50, cursor=page.next_cursor)

CreditLedgerEntry

CreditLedgerPage