Skip to main content

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

ParameterTypeRequiredDescription
idstringYesID 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

FieldTypeDescription
levelstringFinal AML exposure level for the transfer. Possible values:
high
medium
low
undefined
scorenumberNumerical exposure risk score (0–100), where higher means greater AML exposure.
fiat_risk_amountnumberTotal estimated exposure amount in USD associated with risky counterparties.
categoriesarrayDetailed 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.

FieldTypeDescription
categorystringAML category code, e.g.: scam, mixer, exchange, fraud_shop, etc.
sharenumberPercentage share of the total exposure attributed to this category (0.0–1.0). Example: 0.45 = 45%.
fiat_valuenumberUSD 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.
}