{"uid":"cap_OcLH6gaYUftN3W-4MVCFe","slug":"ledgercore-kyag-trace-lookup-6ba1ede0","name":"LedgerCore KYAG Trace Lookup","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/traces","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":100,"minLength":2},"referenceId":{"type":"string","description":"Optional client reference ID"}}},"responseSchema":{"type":"json","example":{"data":{"merchants":[{"name":"Binance","paymentCount":128}]},"x402":{"price":"0.10","token":"USDC","network":"base","resource":"kyag_trace","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_AEu49wgl5XIhVy2q9v0P1","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":"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.","exampleAgentPrompt":"Can you pull a LedgerCore KYAG trace for 'Binance withdrawals 2024' and tell me which merchants show up and how many payments they processed?","exampleUseCases":[{"title":"AML compliance review for wallet","prompt":"I need to run a blockchain trace on the entity 'CryptoExchangeXYZ' to see all merchant payment activity linked to it — pull the KYAG trace and flag any high-volume counterparties."},{"title":"Counterparty due diligence check","prompt":"Before we onboard this new client, can you query LedgerCore for a KYAG trace on 'AlphaTrading' and show me the merchant names and payment counts we should know about?"},{"title":"Transaction pattern investigation","prompt":"Our compliance team needs a KYAG trace report on 'DeFiProtocol2024' — run the query and list every merchant that appears along with how many payments they made."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:26.318Z","isFirstParty":false}