{"uid":"cap_lUqjy9jfznq5CzgQh3jyy","slug":"wallet-sanctions-check-26b21fad","name":"Wallet Sanctions Check","description":"Direct wallet sanctions exposure check on Base. Screens a wallet and a bounded set of recent transfer counterparties, with evidence, coverage, and explicit limitations.","url":"https://wallet-sanctions.use.x402atlas.com/exposure","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","network"],"properties":{"address":{"type":"string","maxLength":42,"minLength":42,"description":"A 20-byte EVM wallet address (0x...)."},"network":{"enum":["eip155:8453"],"type":"string","description":"Base mainnet in CAIP-2 format."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","network","verdict","recommended_action","summary","target","coverage","matches","checked_at","cached","source","limitations"],"properties":{"cached":{"type":"boolean","description":"True when the whole analysis was served from cache, including the pinned documentation example."},"source":{"type":"object","required":["check_type","lists"],"properties":{"lists":{"type":"array","items":{"type":"string"},"description":"Sanctions lists covered by the screening provider."},"check_type":{"enum":["direct_address_sanctions_exposure"],"type":"string"}},"description":"What was checked and against which published lists."},"target":{"type":"object","required":["verdict","is_sanctioned","match","checked_at","cached"],"properties":{"match":{"type":["object","null"],"properties":{"name":{"type":"string","description":"Designated entity name as published by the source list."},"sanctioned_at":{"type":"string","format":"date-time","description":"Designation date reported by the source list."},"listed_blockchain":{"type":"string","description":"Chain the address was designated on, which may differ from the analyzed network."}},"description":"Designation evidence for a positive target match; null when the target is not listed."},"cached":{"type":"boolean","description":"True when the target screen was served from cache."},"verdict":{"enum":["sanctioned","not_listed"],"type":"string","description":"`not_listed` means no exact match was found, not AML clearance."},"checked_at":{"type":"string","format":"date-time","description":"When the target screen was obtained upstream; retained on cache hits."},"is_sanctioned":{"type":"boolean","description":"True only for an exact match of the requested wallet."}},"description":"Exact-address screen of the requested wallet itself, independent of counterparty exposure."},"address":{"type":"string","description":"Validated canonical EIP-55 address of the analyzed wallet."},"matches":{"type":"array","items":{"type":"object","examples":[{"asset":"USDC","value":5000,"address":"0x000000000000000000000000000000000000dEaD","direction":"sent_to","sanctions":{"name":"Placeholder Designated Entity","sanctioned_at":"2025-11-04T00:00:00Z","listed_blockchain":"Ethereum"},"transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000","interaction_count":3,"latest_interaction":"2026-07-19T08:31:22Z"}],"required":["address","direction","interaction_count","latest_interaction","transaction_hash","sanctions"],"properties":{"asset":{"type":"string","description":"Asset symbol of the most recent transfer (for example ETH or USDC); omitted when upstream reports none."},"value":{"type":"number","description":"Decimal-adjusted amount of the most recent transfer denominated in `asset` — token units, NOT USD. Compare thresholds per asset."},"address":{"type":"string","description":"Canonical EIP-55 address of the sanctioned counterparty."},"direction":{"enum":["sent_to","received_from","bidirectional"],"type":"string","description":"Flow direction relative to the requested wallet across the examined transfers."},"sanctions":{"type":"object","properties":{"name":{"type":"string","description":"Designated entity name as published by the source list."},"sanctioned_at":{"type":"string","format":"date-time","description":"Designation date reported by the source list."},"listed_blockchain":{"type":"string","description":"Chain the address was designated on, which may differ from the analyzed network."}},"description":"Designation evidence for this counterparty."},"transaction_hash":{"type":"string","description":"Hash of the most recent such transfer, for on-chain verification."},"interaction_count":{"type":"integer","description":"Number of examined transfers between the wallet and this counterparty."},"latest_interaction":{"type":"string","format":"date-time","description":"Block timestamp of the most recent such transfer."}},"description":"A sanctioned counterparty plus the interaction evidence. The `examples` entry is an illustrative shape only: its address, hash, names, and dates are placeholders, not a real designation."},"description":"One entry per successfully screened counterparty that is an exact sanctions-list match; empty when none matched. An entry describes the counterparty, not the requested wallet."},"network":{"enum":["eip155:8453"],"type":"string","description":"CAIP-2 network the analysis covers."},"summary":{"type":"string","description":"Human-readable interpretation, including the coverage and AML-scope caveats."},"verdict":{"enum":["target_sanctioned","direct_exposure_detected","no_direct_exposure_found"],"type":"string","description":"`target_sanctioned`: the requested wallet itself is an exact list match. `direct_exposure_detected`: the wallet is not listed but at least one screened counterparty is. `no_direct_exposure_found`: neither matched — read `coverage` before treating it as clean, because it is bounded by the reported limits and may be partial."},"coverage":{"type":"object","required":["from","to","lookback_days","transfer_limit","transfers_examined","counterparty_limit","counterparties_discovered","counterparties_screened","counterparties_failed","counterparties_not_screened","truncated","provider_complete"],"properties":{"to":{"type":"string","format":"date-time","description":"Newest transfer timestamp the scan considered."},"from":{"type":"string","format":"date-time","description":"Oldest transfer timestamp the scan considered."},"truncated":{"type":"boolean","description":"True when a transfer or counterparty limit was hit, so the wallet has more history than was assessed."},"lookback_days":{"type":"integer","description":"Configured history window in days."},"transfer_limit":{"type":"integer","description":"Maximum transfers the scan reads before stopping."},"provider_complete":{"type":"boolean","description":"False when any screen failed or an upstream transfer row was unusable. A negative verdict with `false` here is partial, not clean."},"counterparty_limit":{"type":"integer","description":"Maximum unique counterparties this route screens per request."},"transfers_examined":{"type":"integer","description":"Transfers actually read for this wallet."},"counterparties_failed":{"type":"integer","description":"Counterparties whose screen was attempted but errored upstream. They are NOT clean — they are unknown."},"counterparties_screened":{"type":"integer","description":"Counterparties whose sanctions screen completed successfully; only these carry a real result."},"counterparties_discovered":{"type":"integer","description":"Unique counterparties found in the examined transfers."},"counterparties_not_screened":{"type":"integer","description":"Discovered counterparties dropped by `counterparty_limit` and never sent upstream. Also unknown, not clean."}},"description":"Exactly what this analysis did. `counterparties_discovered` = `counterparties_screened` + `counterparties_failed` + `counterparties_not_screened`."},"checked_at":{"type":"string","format":"date-time","description":"When this analysis was assembled; retained on cache hits."},"limitations":{"type":"array","items":{"type":"string"},"description":"Scope caveats that constrain how this result may be used."},"recommended_action":{"enum":["block_and_review","manual_review","no_direct_match"],"type":"string","description":"Suggested handling. `manual_review` is returned both for a counterparty match and for a negative result whose coverage is incomplete; `no_direct_match` only for a negative result with complete coverage."}}}}}}},"responseSchema":{"type":"json","example":{"cached":true,"source":{"lists":["US OFAC","UK OFSI","South Korea MOFA","Israel NBCTF"],"check_type":"direct_address_sanctions_exposure"},"target":{"match":null,"cached":true,"verdict":"not_listed","checked_at":"2026-07-22T12:00:00Z","is_sanctioned":false},"address":"0xD58397875AA3e57f11EE5eDcC4Cda2BCb545D4f7","matches":[],"network":"eip155:8453","summary":"No exact target or direct-counterparty sanctions match was found within the reported analysis limits. This is not AML clearance.","verdict":"no_direct_exposure_found","coverage":{"to":"2026-07-22T12:00:00Z","from":"2025-07-22T12:00:00Z","truncated":false,"lookback_days":365,"transfer_limit":100,"provider_complete":true,"counterparty_limit":20,"transfers_examined":41,"counterparties_failed":0,"counterparties_screened":14,"counterparties_discovered":14,"counterparties_not_screened":0},"checked_at":"2026-07-22T12:00:01Z","limitations":["One-hop direct native and fungible-token transfer analysis only; transfers without two address endpoints (such as contract creation), contract internals, NFTs, wallet clustering, source of funds, identity, and overall AML risk are not assessed.","Interaction with a listed address does not establish ownership, control, or illicit activity; direction, frequency, value, and transaction evidence require contextual review.","A negative result applies only to the reported network, time window, transfer limit, and screened counterparties and must not be interpreted as AML clearance."],"recommended_action":"no_direct_match"}},"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_vhe9mpNNQGlbN4cGLyouR","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":"Screens an EVM wallet address on Base mainnet for direct sanctions exposure and checks a bounded set of recent transfer counterparties against sanctions lists, returning verdicts with evidence and coverage details.","exampleAgentPrompt":"Can you run a sanctions exposure check on the Base wallet 0xAbCd1234567890abcdef1234567890abcdef1234 — I need to know if it's directly sanctioned and whether any recent transfer counterparties are on sanctions lists before I proceed?","exampleUseCases":null,"resultDescription":"Returns a verdict (sanctioned or not_listed) for the target wallet, a list of counterparty matches with interaction direction (sent_to, received_from, bidirectional), sanctions match details (name, sanctioned_at, listed blockchain), coverage metadata, the sanctions lists consulted, cache status, timestamp, recommended action, and explicit limitations of the check.","failureModes":["Invalid or malformed wallet address (not 42 chars or not 0x-prefixed) returns validation error","Unsupported network (non-Base) returns enum validation error","Address with no transaction history may return empty counterparty matches with limited coverage","Rate limiting or payment failure may block the request","Cached results may not reflect the most recent sanctions list updates"],"whenToPreferThis":"Use this endpoint when you need a structured, evidence-backed sanctions screening of a specific Base mainnet wallet with counterparty exposure context — particularly for compliance workflows, pre-payment due diligence, or AML checks on Base. Prefer this over generic blockchain explorers when you need a direct sanctions verdict with list citations, interaction direction, and explicit coverage/limitation disclosures in a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:38.770Z","isFirstParty":false}