Metadata-Version: 2.4
Name: aethoncredit-sdk
Version: 1.0.0
Summary: Python SDK for Aethon Credit Intelligence (ACI) API
Project-URL: Homepage, https://aethoncredit.com/developers
Project-URL: Documentation, https://aethoncredit.com/developers
License: MIT
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# aethoncredit-sdk — ACI Python SDK

## Install

```bash
pip install aethoncredit-sdk
```

## Quick start

```python
from ace import AciClient

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

## Async

```python
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.
