Run KYT on a crypto withdrawal
Know Your Transaction (KYT) screening evaluates a withdrawal against counterparty and exposure signals before you broadcast it. The KYT endpoint returns a single decision your payout logic can act on. Persist every response so the outcome is auditable.
- A live API key with AML scope (Bearer sk_live_...).
- The unsigned or signed transaction hash and the chain it belongs to.
1Submit the transaction for screening
POST the transaction to the KYT endpoint with the direction set to out. This is a C3 call. Reference the transaction by hash so the screen resolves the destination and its exposure.
curl -X POST https://api.1st-node.com/v1/aml/eth/screen \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"tx":"0x9f2c...","direction":"out"}'2Read the decision
The response returns a decision of allow, review, or block alongside the contributing score and exposure. Route allow straight to broadcast, hold review for a human, and stop block entirely.
> { "decision": "review", "score": 58, "risk_level": "medium", "exposure": [{ "category": "gambling", "hops": 2 }] }3Gate the payout on the decision
Wire the decision field into your withdrawal state machine. Only allow proceeds automatically; review and block move the withdrawal to a hold queue instead of broadcasting.
4Store the response for audit
Persist the full KYT response keyed to the withdrawal id. The score, decision, and exposure form the evidence for why the transaction was released or held.
Frequently asked
What does the direction field change?
It tells KYT whether to score the destination (out) or the source (in). For a withdrawal set direction to out so exposure is measured against where funds are going.
Which credit tier does KYT screening consume?
KYT transaction screening is a C3 call. Sanctions-only checks are C2, and a full fund-flow trace is C4.
Keep reading
Top up, get a key, ship.
Self-serve. Pay in crypto or card. Metered by credits — heavy primitives cost more, simple ones are cheap.
Get API key