{"uid":"cap_HvEmBCtEtV5axRUSGYlXL","slug":"aegisaudit-kya-know-your-agent-counterparty-security-assessment-323041b6","name":"AegisAudit KYA (Know Your Agent) Counterparty Security Assessment","description":"Real-time smart contract honeypot swap simulation (Honeypot.is V2), GoPlus bytecode inspection, on-chain owner() verification, and DEX liquidity risk scoring for AI agents via x402.","url":"https://aegis-audit-x402.project-easy-x.workers.dev/api/v1/kya?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Counterparty EVM wallet or agent contract address on Base (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"address":"0x111ef680B6EFdd859FbEc473b907aCe95F0D1acB","network":"eip155:8453","entityType":"EOA_WALLET","kyaAssessment":{"kyaTier":"ESTABLISHED_WALLET","trustScore":72,"ap2SpendMandateMaxUsd":10,"counterpartyRecommendation":"SAFE_TO_TRANSACT"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KRqR6RMUw0xfES08OGAqJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Assesses the trustworthiness and safety of an EVM wallet or smart contract address on Base, returning a trust score, entity type, and transaction recommendation for AI agents.","exampleAgentPrompt":"Before I send any funds, run a KYA security check on 0x111ef680B6EFdd859FbEc473b907aCe95F0D1acB on Base and tell me if it's safe to transact with — I need the trust score and counterparty recommendation.","exampleUseCases":[{"title":"Pre-payment counterparty vetting for DeFi agent","prompt":"I'm about to have my agent send USDC to 0xAbC123...on Base — can you run an AegisAudit KYA check on that address first and tell me the trust score and whether it's safe to transact with?"},{"title":"Token contract honeypot detection before swap","prompt":"Before my trading bot swaps into this token at 0x4e9f2c...on Base, check if the contract is a honeypot and give me a risk score so I know if it's safe to buy."},{"title":"Agent-to-agent trust verification in autonomous workflow","prompt":"My AI agent is about to accept a job from another agent contract at 0x7d3a11...on Base — can you run a KYA assessment and confirm whether that counterparty is trustworthy enough to work with?"}],"resultDescription":"Returns a JSON object with the queried address, the network (eip155:8453 for Base), the entity type (e.g. EOA_WALLET or smart contract), a numeric trust score (0-100), a KYA tier label (e.g. ESTABLISHED_WALLET), a maximum recommended spend mandate in USD, and a counterparty recommendation (e.g. SAFE_TO_TRANSACT or a warning).","failureModes":["Invalid or malformed address returns an error response","Address not found on Base network returns empty or unknown entity result","GoPlus or Honeypot.is upstream APIs unavailable causes degraded or failed response","Non-Base EVM addresses may not be supported, returning an unsupported network error","Rate limiting or payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a fast, multi-oracle security check on an EVM address on Base before executing any financial transaction or accepting instructions from a counterparty. It is especially valuable in autonomous agent workflows where trust must be established programmatically without human review, combining honeypot simulation, bytecode inspection, and liquidity risk into a single scored verdict.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:19:46.452Z","isFirstParty":false,"canonicalSlug":"aegisaudit-kya-know-your-agent-counterparty-security-assessment-323041b6"}