{"uid":"cap_3QrukSNDUEkP9aGnXIsMa","slug":"chainverdict-wallet-dossier-api-858908c3","name":"ChainVerdict Wallet Dossier API","description":"x402 v2 pay-per-call. Unpaid requests receive HTTP 402 with payment requirements.","url":"https://chainverdict.xyz/v1/wallet/dossier/%7Baddress%7D","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"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Base address (EOA or contract)"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"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_4SHkCyA2cwOouwN1vBNUQ","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":"Retrieves a comprehensive on-chain dossier (profile, risk assessment, and activity summary) for a given blockchain wallet address (EOA or contract).","exampleAgentPrompt":"Can you pull the full on-chain dossier for wallet address 0x742d35Cc6634C0532925a3b8D4C9b4B5F3a1e2f3 and tell me if it looks risky or has any red flags?","exampleUseCases":[{"title":"Pre-transaction counterparty risk check","prompt":"Before I send 5 ETH to 0xAbCd1234...5678, can you pull a ChainVerdict dossier on that address and tell me if there are any red flags or risk signals I should know about?"},{"title":"DeFi protocol wallet vetting","prompt":"We're about to whitelist 0x3fB5c1CB00000... as a liquidity provider — can you get me its full on-chain dossier so we can check its history and whether it's been flagged for anything suspicious?"},{"title":"Investigating an unknown sender","prompt":"I just received tokens from 0xDeAdBeEf...9999 out of nowhere — can you look up a dossier on that address and tell me what kind of wallet it is and what it's been involved in?"}],"resultDescription":"Returns a structured dossier for the queried wallet address, likely including: address type (EOA vs contract), on-chain activity summary, risk indicators or verdict score, transaction history highlights, associated labels or tags, and any known flags (e.g. mixer use, sanctioned counterparties, scam involvement).","failureModes":["HTTP 402 returned if payment is not included — caller must pay $0.01 USDC via x402 protocol","Invalid or malformed address returns an error (e.g. 400 Bad Request)","Unknown or brand-new address with no on-chain history may return sparse/empty dossier","Rate limiting or service unavailability returns 429 or 503","Address not found on the supported chain returns empty or null result"],"whenToPreferThis":"Choose this endpoint when you need a holistic, pre-packaged 'dossier' view of a blockchain wallet — combining risk scoring, activity profiling, and address classification in one pay-per-call lookup. Prefer it over raw blockchain RPCs or block explorers when you want structured risk intelligence rather than raw transaction data. Best suited for agent workflows doing counterparty due diligence, fraud detection, or wallet vetting at $0.01 per lookup cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:42:22.534Z","isFirstParty":false}