ACI Risk Indicators

List ACI Risk Indicator modules with live provider counts and criteria counts. Access: no sign-in needed.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search providers with a current ACI Risk Indicator by free text and/or module, risk band, or subtype. Returns headline fields for each match: `slug`, `name`, `module`, the indicator value (`score`), `risk_band` and `subtype`. Access: no sign-in needed. Below the Professional plan, results show name, module and risk band only.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text match on provider name or slug."
    },
    "module": {
      "type": "string",
      "description": "Filter by module code (planner_type)."
    },
    "risk_band": {
      "type": "string",
      "description": "Filter by risk band: LOW|MEDIUM|ELEVATED|HIGH."
    },
    "subtype": {
      "type": "string",
      "description": "Filter by provider subtype."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max rows (default 25)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the current ACI Risk Indicator for one provider, by slug or name. Access: Professional plan and above. If the user is not signed in, calling this tool starts the sign-in to their Aethon Credit Intelligence account.

{
  "type": "object",
  "properties": {
    "provider_slug": {
      "type": "string",
      "description": "Provider slug or UUID."
    },
    "provider_name": {
      "type": "string",
      "description": "Provider display name."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the full breakdown of one provider's current ACI Risk Indicator: per-criterion values, weights, weighted contributions, confidence and hard caps, plus the stress classification where one is stored. Access: Professional plan and above. If the user is not signed in, calling this tool starts the sign-in to their Aethon Credit Intelligence account.

{
  "type": "object",
  "properties": {
    "provider_slug": {
      "type": "string",
      "description": "Provider slug or UUID."
    }
  },
  "required": [
    "provider_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare 2–5 providers side by side: full details plus a per-criterion comparison matrix. Access: Professional plan and above. If the user is not signed in, calling this tool starts the sign-in to their Aethon Credit Intelligence account.

{
  "type": "object",
  "properties": {
    "slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 5,
      "description": "2–5 provider slugs (or UUIDs) to compare."
    }
  },
  "required": [
    "slugs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Assess the composite risk of an allocation of 2–20 providers (weights summing to ~1.0). Returns a capital-weighted composite (`composite_score`), a per-provider breakdown, counterparty concentration, and elevated-exposure warnings. The composite is an ANALYTICAL aggregate of the providers' ACI Risk Indicators, not an ACI Risk Indicator itself. The custody, regulatory and stress fields are module-specific and null for a mixed-module portfolio. Access: Professional plan and above. If the user is not signed in, calling this tool starts the sign-in to their Aethon Credit Intelligence account.

{
  "type": "object",
  "properties": {
    "allocations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider_slug": {
            "type": "string"
          },
          "weight": {
            "type": "number"
          }
        },
        "required": [
          "provider_slug",
          "weight"
        ],
        "additionalProperties": false
      },
      "minItems": 2,
      "maxItems": 20,
      "description": "2–20 positions; weights between 0.01 and 1.0 summing to ~1.0."
    }
  },
  "required": [
    "allocations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Map up to 200 positions, each given by its identifiers, to the ACI Risk Indicators of the providers behind them. Accepted identifiers: a venue, composite or share-class FIGI; a ticker with its MIC; an LEI; a chain id with a contract address; an ACI provider slug; a DTI. ISINs and CUSIPs are not accepted, and a position carrying one is refused. Each position comes back, in input order, with an `outcome`: `resolved`, with the instrument, every role and entity linked to it, and the provider's `risk_band`, `score` and `snapshot_id`; `ambiguous`, with the candidates, which a `module_hint` narrows; `withheld`; `uncovered`; or `out_of_scope`. Every outcome but `resolved` carries a `reason_code`. Nothing is guessed: an identifier matches exactly or not at all. A position carries its identifiers only; market values are not accepted. Access: Professional plan and above. If the user is not signed in, calling this tool starts the sign-in to their Aethon Credit Intelligence account.

{
  "type": "object",
  "properties": {
    "positions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "identifiers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "`figi`, `ticker_mic`, `lei`, `chain_contract`, `provider_slug` or `dti`. Any other type, an ISIN or a CUSIP among them, is refused together with the position that carries it."
                },
                "value": {
                  "type": "string",
                  "description": "The identifier, for `figi`, `lei`, `provider_slug` and `dti`."
                },
                "ticker": {
                  "type": "string",
                  "description": "For `ticker_mic`: the ticker."
                },
                "mic": {
                  "type": "string",
                  "description": "For `ticker_mic`: the ISO 10383 MIC of the venue, or its operating MIC."
                },
                "chain": {
                  "type": "string",
                  "description": "For `chain_contract`: the CAIP-2 chain id, such as `eip155:1`."
                },
                "contract": {
                  "type": "string",
                  "description": "For `chain_contract`: the contract address."
                }
              },
              "required": [
                "type"
              ],
              "additionalProperties": true
            },
            "minItems": 1,
            "description": "One or more identifiers of the position."
          },
          "position_ref": {
            "type": "string",
            "description": "The caller's own opaque reference, echoed in the result and never used to resolve: at most 64 characters from A-Z, a-z, 0-9 and . _ : -. Not a client name or an account number."
          },
          "module_hint": {
            "type": "object",
            "properties": {
              "planner_type": {
                "type": "string",
                "enum": [
                  "btc",
                  "fiat",
                  "stablecoin",
                  "infrastructure",
                  "market_neutral",
                  "venture",
                  "tokenised_rwa",
                  "volatility",
                  "digital_asset_etp"
                ],
                "description": "The module's `planner_type`."
              },
              "provider_subtype": {
                "type": "string",
                "description": "The module's `provider_subtype`, where the subtype is its own module (`cefi` or `defi` for stablecoins)."
              }
            },
            "required": [
              "planner_type"
            ],
            "additionalProperties": false,
            "description": "Narrows this position to one module. Answers an `ambiguous` result with one of its candidates' modules."
          }
        },
        "required": [
          "identifiers"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 200,
      "description": "1 to 200 positions."
    },
    "mapping_seq": {
      "type": "integer",
      "minimum": 1,
      "description": "A published mapping version to pin, by number. The latest by default. An unknown number is refused, never replaced."
    }
  },
  "required": [
    "positions"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}