aethoncredit-sdk

aethoncredit-sdk — ACI Python SDK

Install

pip install aethoncredit-sdk

Quick start

from ace import AciClient

client = AciClient(api_key="sk_live_...")
score = client.get_score("coinbase-prime")
print(score.score, score.band)

Async

from ace import AciAsyncClient
import asyncio

async def main():
    client = AciAsyncClient(api_key="sk_live_...")
    score = await client.get_score("coinbase-prime")
    print(score.score, score.band)

asyncio.run(main())

Endpoints covered

• GET /api/v1/scores/{provider_id} — single provider score
• GET /api/v1/scores — list provider scores (filters: module, band)
• GET /api/v1/computation/{id} — Phase 1 computation package (PRO+ tier)
• GET /api/health — unauthenticated health probe

Authentication

The SDK sends the API key in the x-api-key request header (matching the canonical ACI API gateway). Bearer tokens are not used.

List filtering

AciClient.list_scores(module=..., band=...) maps module to the server-side planner_type query parameter. The band filter is applied client-side after the response is received.

Computation package shape

ComputationPackage mirrors the API's data payload exactly:

• package: dict[str, Any] — Phase 1 package contents (free-form)
• package_hash: str — SHA-256 of the canonical package bytes
• methodology_version: str
• engine_version: str
• published_at: datetime

The score, snapshot id, and other internals live inside the package dict — see the /api/v1/computation/{id} endpoint documentation for the package schema.

Docs

https://aethoncredit.com/developers

ACI Framework v1.0 · Quantitative risk analytics outputs for independent analysis.