{"uid":"cap_IvmzkwpzfcJcUCSzmZTRb","slug":"ledgercore-kya-know-your-address-risk-report-9b345318","name":"LedgerCore KYA (Know Your Address) Risk Report","description":"KYA address risk report — pay per use via x402","url":"https://api.ledgercore.io/api/v1/x402/kya/report","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4tM3p6_Ox0A4rl8Ho0I-w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates an institutional-grade blockchain address risk report (KYA) for a given address and chain, optionally scoped to an ERC-20 asset on Ethereum.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:42:18.671Z","isFirstParty":false}