# LedgerCore KYAG Trace Lookup

> LedgerCore KYAG Trace Lookup 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-15).

Queries blockchain transaction traces linked to a known-address graph (KYAG) node, returning associated merchant activity and payment flows for compliance and intelligence use cases.

## Facts

- Endpoint: POST https://api.ledgercore.io/api/v1/x402/kyag/traces
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ledgercore-kyag-trace-lookup-6ba1ede0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OcLH6gaYUftN3W-4MVCFe

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-trace-lookup-6ba1ede0 -d '<json body>'
```

Example prompt: Can you pull a LedgerCore KYAG trace for 'Binance withdrawals 2024' and tell me which merchants show up and how many payments they processed?

## When to prefer this

Choose this endpoint when you need on-chain transaction trace data linked to a specific named entity or address graph node, especially for institutional compliance, AML investigations, or counterparty due diligence workflows. It is particularly suited when you need merchant-level payment attribution rather than raw transaction data, and when you are operating in a pay-per-query model via USDC on Base via the x402 protocol.

## Known failure modes

- Query string too short (below 2 characters) — validation error returned
- Query string too long (above 100 characters) — validation error
- No matching KYAG trace found for query — empty merchants array
- Payment not accepted or insufficient USDC balance — x402 payment failure
- Invalid or malformed referenceId — request rejected
- Network or API downtime — 5xx error response

## 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 containing a list of merchants associated with the traced KYAG node, each with their name and payment count, along with x402 payment metadata confirming the charge (price, token, network, resource type) and a success flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 100,
   "minLength": 2
  },
  "referenceId": {
   "type": "string",
   "description": "Optional client reference ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "merchants": [
    {
     "name": "Binance",
     "paymentCount": 128
    }
   ]
  },
  "x402": {
   "price": "0.10",
   "token": "USDC",
   "network": "base",
   "resource": "kyag_trace",
   "paymentAccepted": true
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ledgercore-kyag-trace-lookup-6ba1ede0/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)