Register a crypto transfer with Chainalysis KYT v2 API for deposit screening

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. Authenticate: set the Token header to YOUR_API_KEY on all requests to https://api.chainalysis.com
  2. Register an incoming deposit for monitoring: POST https://api.chainalysis.com/api/kyt/v2/users/{userId}/transfers with body: {"network": "ETHEREUM", "asset": "USDC", "transferReference": "<txHash>:0", "direction": "RECEIVED"}
  3. Poll GET /api/kyt/v2/users/{userId}/transfers/{transferReference} or wait for the updated_alerts webhook; the rating field (LOW/MEDIUM/HIGH/SEVERE) reflects the current risk assessment
  4. Retrieve alerts: GET /api/kyt/v2/alerts?transferReference=<ref> to get structured alert objects including externalId, alertLevel, and category
  5. For high-severity alerts (HIGH or SEVERE), place a hold on the associated user account and initiate enhanced due diligence per your AML policy
  6. Resolve alerts after review: PUT /api/kyt/v2/alerts/{alertId} with {"status": "REJECTED", "comment": "<disposition_note>"} or ACCEPTED to record compliance decisions

Known gotchas

Related routes

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
Use Chainalysis KYT v2 to pre-screen a withdrawal address before executing a transfer
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

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