Use Chainalysis KYT v2 to pre-screen a withdrawal address before executing a transfer

domain: kytdoc.kyt-dev.e.chainalysis.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. 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>"}
  2. 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
  3. Apply your withdrawal policy: block SEVERE and HIGH-rated addresses; queue MEDIUM for enhanced review; allow LOW with audit logging
  4. 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>}
  5. 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
  6. Store Chainalysis rating and timestamp with each withdrawal record; most AML programs require a pre-send screening log retained for 5+ years

Known gotchas

Related routes

Register a crypto transfer with Chainalysis KYT v2 API for deposit screening
kytdoc.kyt-dev.e.chainalysis.com · 6 steps · unrated
Screen a transaction against Chainalysis sanctions data using the Address Screening API
kytdoc.kyt-dev.e.chainalysis.com · 6 steps · unrated
Implement Know Your Transaction (KYT) monitoring by submitting a cryptocurrency transfer to the Chainalysis KYT API and retrieving the risk exposure
docs.chainalysis.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans