{"uid":"cap_q9CYu74Mm9YTHuGbLWnzJ","slug":"ledgercore-kyag-know-your-agent-address-risk-scoring-8f5db5e9","name":"LedgerCore KYAG (Know Your Agent/Address) Risk Scoring","description":"LedgerCore is the institutional blockchain intelligence platform. One unified API with targeted portals for market data, treasury, compliance, and asset integrity.","url":"https://api.ledgercore.io/api/v1/x402/kyag/job","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}},"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_zNNuteE9pCOM5qAo4ShPj","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":"Scores the risk and trust level of a blockchain wallet address, agent ID, or external platform identity using institutional-grade on-chain intelligence.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-payment wallet risk screening","prompt":"Before I send 50,000 USDC to wallet 0x4f3edf983ac636a65a842ce7c78d9aa706d3b113 on Ethereum, can you run a KYAG risk check on it and tell me the grade and trust score?"},{"title":"AI agent compliance vetting","prompt":"I need to verify the risk profile of an agent before onboarding it — can you run a KYAG check on agent ID agt_9f2c8d1a3b and give me the full risk and trust scores?"},{"title":"External platform identity assessment","prompt":"We're integrating a counterparty from Coinbase with external ID cb_user_7743 — can you pull a LedgerCore risk grade for them so our compliance team can review before we proceed?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:35:52.418Z","isFirstParty":false}