# LedgerCore KYAG (Know Your Agent/Address) Risk Scoring

> LedgerCore KYAG (Know Your Agent/Address) Risk Scoring is a paid API for AI agents from api.ledgercore.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Scores the risk and trust level of a blockchain wallet address, agent ID, or external platform identity using institutional-grade on-chain intelligence.

## Facts

- Endpoint: POST https://api.ledgercore.io/api/v1/x402/kyag/job
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ledgercore-kyag-know-your-agent-address-risk-scoring-8f5db5e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q9CYu74Mm9YTHuGbLWnzJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ledgercore-kyag-know-your-agent-address-risk-scoring-8f5db5e9 -d '<json body>'
```

Example prompt: Run a LedgerCore KYAG risk check on the Ethereum wallet 0xAbC123... and tell me the risk grade, trust score, and confidence level — I need to know if it's safe to send funds to.

## When to prefer this

Choose this endpoint when you need institutional-grade risk and trust scoring for blockchain wallets, AI agent identities, or external platform accounts — especially when compliance, due diligence, or pre-transaction screening is required. It supports multiple subject types (wallet, agent ID, external ID) in one unified call, making it ideal for multi-context compliance pipelines. Prefer it over generic blockchain explorers when you need a structured risk grade and trust score rather than raw transaction history.

## Known failure modes

- Invalid or malformed wallet address returns validation error
- Unsupported chain identifier causes lookup failure
- Unknown agent ID (missing 'agt_' prefix) rejected by schema validation
- Insufficient on-chain data for low-activity addresses may yield low confidence score
- Payment not accepted or insufficient funds triggers x402 payment failure
- Network or service downtime returns 5xx error

## How this service works

LedgerCore is the institutional blockchain intelligence platform. One unified API with targeted portals for market data, treasury, compliance, and asset integrity.

## Output

Returns a JSON object with a letter grade (e.g. 'B'), a numeric risk score (0–100, lower is safer), a trust score (0–100, higher is better), a confidence percentage, and the scoring model version used (e.g. 'kyag-risk-v1'). Also includes x402 payment confirmation metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "subject": {
   "oneOf": [
    {
     "type": "object",
     "required": [
      "type",
      "chain",
      "address"
     ],
     "properties": {
      "type": {
       "enum": [
        "wallet"
       ],
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "address": {
       "type": "string"
      }
     }
    },
    {
     "type": "object",
     "required": [
      "type",
      "agentId"
     ],
     "properties": {
      "type": {
       "enum": [
        "agent_id"
       ],
       "type": "string"
      },
      "agentId": {
       "type": "string",
       "pattern": "^agt_"
      }
     }
    },
    {
     "type": "object",
     "required": [
      "type",
      "externalId"
     ],
     "properties": {
      "type": {
       "enum": [
        "external_id"
       ],
       "type": "string"
      },
      "platform": {
       "type": "string"
      },
      "externalId": {
       "type": "string"
      }
     }
    }
   ]
  },
  "referenceId": {
   "type": "string",
   "description": "Optional client reference ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "grade": "B",
   "confidence": 60,
   "risk_score": 32,
   "trust_score": 68,
   "scoring_version": "kyag-risk-v1"
  },
  "x402": {
   "price": "0.10",
   "token": "USDC",
   "network": "base",
   "resource": "kyag_report",
   "paymentAccepted": true
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ledgercore-kyag-know-your-agent-address-risk-scoring-8f5db5e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ledgercore.io](https://www.zero.xyz/host/api.ledgercore.io/llms.txt)