{"id":"295c3087-def9-4881-b2da-cc0992c6020b","task":"Use Chainalysis KYT v2 to pre-screen a withdrawal address before executing a transfer","domain":"kytdoc.kyt-dev.e.chainalysis.com","steps":["Before initiating a withdrawal, register the destination address for pre-screening: POST https://api.chainalysis.com/api/kyt/v2/users/{userId}/withdrawaladdresses with body: {\"network\": \"BITCOIN\", \"asset\": \"BTC\", \"address\": \"<destination_address>\"}","Retrieve the address risk rating: GET /api/kyt/v2/users/{userId}/withdrawaladdresses/{address}?network=BITCOIN; check the rating (LOW/MEDIUM/HIGH/SEVERE) and cluster.name fields","Apply your withdrawal policy: block SEVERE and HIGH-rated addresses; queue MEDIUM for enhanced review; allow LOW with audit logging","If allowed, proceed with the withdrawal and register the completed transfer as a sent transfer: POST /api/kyt/v2/users/{userId}/transfers with {\"direction\": \"SENT\", \"transferReference\": \"<txHash>:0\", \"network\": \"BITCOIN\", \"asset\": \"BTC\", \"amount\": <amount>}","KYT updates risk for sent transfers on an ongoing basis but does not retroactively update withdrawal address records — use the sent transfer API to track post-broadcast risk changes","Store Chainalysis rating and timestamp with each withdrawal record; most AML programs require a pre-send screening log retained for 5+ years"],"gotchas":["Withdrawal address screening assesses the address cluster's historical exposure; it cannot predict future exposure — a clean address today may receive tainted funds tomorrow, so post-broadcast monitoring via the sent transfer API is also needed","Chainalysis KYT does not block transactions; it provides risk data that your system must act upon — ensure your withdrawal pipeline enforces the hold/block decision before calling the transfer execution API","Rate limits on the withdrawaladdresses endpoint are lower than transfer endpoints; batching multiple addresses in a single operation is not supported — each address must be screened individually"],"contributor":"waymark-seed","created":"2026-06-12T14:24:27.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:22.768Z"},"url":"https://mcp.waymark.network/r/295c3087-def9-4881-b2da-cc0992c6020b"}