ACI DEVELOPER PLATFORM

Read ACI Risk Indicators over HTTP.

A versioned REST API returning deterministic Risk Indicators under ACI Framework v1.0.

Access

API credentials are provisioned by ACI for eligible Professional and Enterprise accounts. They are not issued automatically at subscription checkout. To request access, contact sales@aethoncredit.com. Credentials are issued after an authorised Contract Admin accepts the applicable API terms.

Requests authenticate with an x-api-key request header. A valid credential without the entitlement receives 403.

x-api-key: sk_live_your_key_here

Endpoints

Method	Endpoint	Description	Requires
GET	/api/v1/scores	All provider Risk Indicators. Optional: ?planner_type=	Professional+
GET	/api/v1/scores/{providerId}	One provider, including criterion breakdown and decision object	Professional+
GET	/api/v1/methodology	Framework version, module weights and hard rules	Professional+
GET	/api/v1/computation/{id}	Computation package for a published Risk Indicator	Enterprise
GET	/api/v1/status	Service status and framework version	Public
GET	/api/public/scores	Headline score and band per provider. No criterion breakdown, no decision object. Rate limited by IP.	Public

Quickstart

import { ACIClient } from '@aethoncredit/sdk'

const client = new ACIClient({
  apiKey: process.env.ACI_API_KEY,
})

const scores = await client.getScores()
const one    = await client.getScore('provider-id')

Response shape

A real response from GET /api/public/scores, trimmed to one row. Authenticated endpoints at Professional and above return additional fields: aci_decision_object, criterion_scores and score_commentary.

{
  "data": [
    {
      "id": "db9db027-b97f-4c8f-b0e6-a55d510c46ba",
      "name": "Unchained",
      "planner_type": "btc",
      "provider_subtype": "custodial",
      "yield_min": 15.2,
      "yield_max": 15.2,
      "final_score": 98,
      "risk_band": "LOW",
      "scored_at": "2026-06-30T00:00:00+00:00"
    }
  ],
  "limitations_disclosure": "…",
  "cached": true
}

Determinism

Risk Indicator calculations are deterministic when the approved inputs, methodology version and configuration are held constant.

OpenAPI specification

The endpoints above are described by a machine-readable OpenAPI 3.1 specification.

/api/v1/openapi.json →

Agent workflows

Copy-paste prompt templates for any LLM. Each directs the model to read fields off an ACI response and stay within them. No API calls are embedded. Machine-readable ACI metadata is at aethoncredit.com/llms.txt.

MCP integration — controlled pilot

ACI MCP access is being evaluated with selected contracted Professional and Enterprise customers. It is not generally available, and no public directory registration has been completed. Production access requires express enablement, applicable contractual acceptance and ACI-issued credentials.

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