# LedgerCore KYA (Know Your Address) Risk Report

> LedgerCore KYA (Know Your Address) Risk Report 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).

Generates an institutional-grade blockchain address risk report (KYA) for a given address and chain, optionally scoped to an ERC-20 asset on Ethereum.

## Facts

- Endpoint: POST https://api.ledgercore.io/api/v1/x402/kya/report
- 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-kya-know-your-address-risk-report-9b345318
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IvmzkwpzfcJcUCSzmZTRb

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-kya-know-your-address-risk-report-9b345318 -d '<json body>'
```

Example prompt: Run a KYA risk report on the Ethereum address 0xAbC123...def on the ethereum chain — I need to know if it has any compliance red flags before we send funds.

## When to prefer this

Use this endpoint when you need institutional-grade, compliance-focused risk intelligence on a specific blockchain address — particularly for AML/KYC screening, treasury due diligence, or pre-transaction risk checks. Prefer this over generic on-chain analytics when you need a structured, KYA-formatted report rather than raw transaction data. Best suited for Ethereum and ERC-20 asset scoped analyses given the asset parameter support.

## Known failure modes

- Missing required 'address' or 'chain' field returns a 400 validation error
- Invalid or malformed blockchain address format may result in an error or empty report
- Unsupported chain identifier causes a rejection
- Payment not accepted / insufficient USDC balance results in 402 payment required
- ERC-20 asset address provided for non-Ethereum chain may cause an error
- Rate limiting or server errors may return 429 or 5xx responses

## How this service works

KYA address risk report — pay per use via x402

## Output

Returns a structured KYA risk report object containing address risk intelligence (risk scores, exposure flags, compliance signals), plus payment confirmation metadata indicating the 1 USDC charge was accepted and the resource type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "description": "ERC-20 contract address (ethereum only). Omit to include all assets."
  },
  "chain": {
   "enum": [
    "bitcoin",
    "ethereum",
    "solana",
    "binance-smart-chain",
    "tron",
    "ripple",
    "polygon",
    "arbitrum",
    "optimism",
    "base",
    "litecoin",
    "dogecoin",
    "bitcoin-cash",
    "avalanche"
   ],
   "type": "string",
   "description": "Blockchain network"
  },
  "address": {
   "type": "string",
   "description": "Blockchain address to analyze"
  },
  "reference_id": {
   "type": "string",
   "description": "Optional client reference ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "status": "completed",
   "api_type": "KYA",
   "risk_level": "low",
   "risk_score": 8
  },
  "x402": {
   "price": "0.10",
   "token": "USDC",
   "network": "base",
   "resource": "kya_report",
   "paymentAccepted": true
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ledgercore-kya-know-your-address-risk-report-9b345318/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)