Recheck Transfer Counterparty
Triggers a new counterparty analysis for a previously registered transfer.
Use this endpoint when:
- AML databases or sanctions lists were updated
- entity attribution has changed
- new intelligence became available
- the transfer was reprocessed
- you want to refresh the counterparty risk profile
HTTP Request
POST /v1/transfers/{id}/recheck-counterparty/
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | ID of the registered transfer. |
Request Body
This request does not require a body.
Response
Response
Returns a REGISTERED_TRANSFER_EXTRA object.
This structure contains:
- base transfer information
- updated exposure
- risk-level aggregation
- assets and fiat valuation
- address chain attribution
- service categories
- AML score results
REGISTERED_TRANSFER_EXTRA Structure
The exposure field contains AML exposure analysis results for the transfer.
It includes total risk value, category breakdown, and scoring data.
Exposure Object
| Field | Type | Description |
|---|---|---|
level | string | Final AML exposure level for the transfer. Possible values: • high • medium • low • undefined |
score | number | Numerical exposure risk score (0–100), where higher means greater AML exposure. |
fiat_risk_amount | number | Total estimated exposure amount in USD associated with risky counterparties. |
categories | array | Detailed breakdown of risky exposure grouped by AML category. See table below. |
Exposure Category Item
Each entry describes how much of the total exposure comes from a specific AML category.
| Field | Type | Description |
|---|---|---|
category | string | AML category code, e.g.: scam, mixer, exchange, fraud_shop, etc. |
share | number | Percentage share of the total exposure attributed to this category (0.0–1.0). Example: 0.45 = 45%. |
fiat_value | number | USD amount attributed to this category from the total fiat_risk_amount. |
Example Response (REGISTERED_TRANSFER_EXTRA)
{
"id": "0192cf57-feab-7be0-9c79-9dfeaa59f6a9",
"tx_hash": "0x77671ed141b61c4234681c5c03dc709a018d2f5bef5881ec8c694cb48acb4e5d",
"network": "ETH",
"direction": "incoming",
"status": "done",
"created_at": "2025-02-01T14:19:32.310015+00:00",
"updated_at": "2025-02-01T14:20:05.430192+00:00",
"amount": "0.934501",
"fiat_value": {
"currency": "USD",
"rate": 2246.381,
"value": 2099.01
},
"asset": {
"type": "native",
"symbol": "ETH",
"token_id": null
},
"exposure": {
"level": "high",
"score": 92,
"fiat_risk_amount": 1931.08,
"categories": [
{
"category": "scam",
"share": 0.45,
"fiat_value": 944.05
},
{
"category": "mixer",
"share": 0.33,
"fiat_value": 689.05
},
{
"category": "exchange",
"share": 0.22,
"fiat_value": 397.98
}
]
},
"counterparty": {
"address": "0x98f79674d5f2f777d44e253bfaf905d7491e8cef",
"service_category": "mixer",
"service_name": "Tornado Cash",
"risk_level": "high",
"risk_score": 95
},
"address_chain": {
"hops": 4,
"path": [
{
"from": "0xabc123...",
"to": "0x111222...",
"category": "scam",
"risk_level": "high"
},
{
"from": "0x111222...",
"to": "0x333444...",
"category": "mixer",
"risk_level": "high"
},
{
"from": "0x333444...",
"to": "0x98f79674d5f2f777d44e253bfaf905d7491e8cef",
"category": "exchange",
"risk_level": "medium"
}
]
}
}
Try it
POST/v1/transfers/{id}/recheck-counterparty/
API KEY ID
API KEY SECRET
Path params
id
Body (JSON)
HTTP Request
Press "Send Request" to generate HTTP request.
HTTP …
{
// Response will be shown here after the request.
}