Skip to main content

Check transfer

Performs a manual AML/KYT check of a single blockchain transfer identified by transaction hash and direction.

Use this endpoint when you already know the on-chain transaction hash and want to evaluate the transfer for AML risk.


HTTP Request

POST /v1/manual-checks/check-transfer/


Request body

The request must specify the network, transaction hash, analysed side of the transfer, and optional token / risk model.

{
"network": "string",
"token_id": "string | null",
"tx_hash": "string",
"output_address": "string",
"direction": "string",
"risk_model": "string | null"
}

Field descriptions

FieldTypeRequiredDescription
networkstringYesBlockchain network code (e.g. ETH, BTC, TRX).
token_idstring or nullNoToken contract address, or "native" for the chain’s native asset.
tx_hashstringYesTransaction hash of the transfer to check.
output_addressstringYesAddress considered as the client side of this transfer (recipient for incoming, sender for outgoing).
directionstringYesDirection of the transfer relative to output_address: incoming or outgoing.
risk_modelstring or nullNoCustom risk model ID to apply. If omitted, the default model is used.

Example request

{
"network": "ETH",
"token_id": "native",
"tx_hash": "0xd74f7e2a5081eb82c1d0a4fbd1859f23bed5fab8280f0aaf9e987019acc973a1",
"output_address": "0x2A6Ced4B10769147824A36e3D646eDA222E50f2A",
"direction": "incoming"
}

Response

Returns a manual check object with current status and risk data for the transfer.

Manual check object

FieldTypeDescription
idstringID of the manual check.
created_atstring (ISO8601)When the check was created.
check_typestringType of check (e.g. deposit, withdrawal).
check_statusstringStatus of the check: checking, checked.
checked_atstring or nullWhen the check was finished (if completed).
transferobject or nullTransfer details (network, token, tx hash, addresses, amount, fiat value). Present for transfer checks.
addressobject or nullAddress details (used for address-only checks). null for transfer checks.
risk_levelstringAML risk level: high, medium, low, undefined.
risk_scorenumber or nullNumerical risk score.
fiat_currencystringFiat currency code used in risk calculations (USD).

Example response

{
"id": "dda28996-5aac-4e6c-9844-e4e658b466ca",
"created_at": "2025-11-27T16:46:56.687761+03:00",
"check_type": "deposit",
"check_status": "checking",
"checked_at": null,
"transfer": {
"network": "ETH",
"token_id": "native",
"token_symbol": "ETH",
"tx_status": "bound",
"tx_hash": "0xd74f7e2a5081eb82c1d0a4fbd1859f23bed5fab8280f0aaf9e987019acc973a1",
"occurred_at": "2024-02-29T19:24:59+03:00",
"input_address": "0x98f79674d5f2f777d44e253bfaf905d7491e8cef",
"output_address": "0x2a6ced4b10769147824a36e3d646eda222e50f2a",
"direction": "incoming",
"amount": 7.2181350653139,
"value_in_fiat": 24403.099580450544
},
"address": null,
"risk_level": "undefined",
"risk_score": null,
"fiat_currency": "USD"
}

Try it

POST/v1/manual-checks/check-transfer/
API KEY ID
API KEY SECRET
Body (JSON)
HTTP Request
Press "Send Request" to generate HTTP request.
HTTP …
{
// Response will be shown here after the request.
}