Recheck Transfer Exposure

Triggers a new exposure calculation for a previously registered transfer.

Use this endpoint when:

• exposure scoring rules were updated
• attribution or risk data changed
• market data needs to be refreshed
• transfer was reprocessed or edited
• you want to manually recompute exposure

---

HTTP Request

POST /v1/transfers/{id}/recheck-exposure/

---

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	ID of the registered transfer.

---

Request Body

This request does not require a body.

---

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

{
  "id": "4a8c8cd2-8e44-4f00-b36e-44a8cf8d129b",
  "tx_hash": "0x9ad4b8bd64c8f124ab620cfe4e11bc2b15f2a41b96cf2e1d7a79cca1cc3d1f91",
  "network": "ETH",
  "direction": "incoming",
  "status": "done",
  "created_at": "2025-11-20T11:10:45.120000Z",
  "updated_at": "2025-11-20T11:10:45.450000Z",

  "amount": "2.1345",
  "fiat_value": {
    "value": 4382.55,
    "currency": "USD",
    "rate": 2053.10
  },

  "asset": {
    "type": "native",
    "symbol": "ETH",
    "token_id": null
  },

  "exposure": {
    "level": "medium",
    "score": 62,
    "fiat_risk_amount": 2717.18,
    "categories": [
      {
        "category": "exchange",
        "share": 0.56,
        "fiat_value": 2454.63
      },
      {
        "category": "mixer",
        "share": 0.44,
        "fiat_value": 1927.92
      }
    ]
  },

  "counterparty": {
    "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "service_category": "exchange",
    "service_name": "Binance",
    "risk_level": "medium",
    "risk_score": 58
  },

  "address_chain": {
    "hops": 3,
    "path": [
      {
        "from": "0xabc123...",
        "to": "0xdef456...",
        "category": "mixer",
        "risk_level": "high"
      },
      {
        "from": "0xdef456...",
        "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "category": "exchange",
        "risk_level": "medium"
      }
    ]
  }
}

---

Field Groups

General Fields

Field	Type	Description
id	string	Unique transfer ID
network	string	Blockchain network (ETH, BTC, TRX)
direction	string	incoming / outgoing
status	string	checking / done / failed
tx_hash	string	Transaction hash

---

Asset & Amount

Field	Description
amount	Transfer amount in token units
asset	Token/currency descriptor
fiat_value	Valuation at time of processing

---

Exposure

Field	Description
exposure.level	high / medium / low / undefined
exposure.score	0–100 numeric score
exposure.categories	Breakdown by AML category with shares and fiat risk
fiat_risk_amount	Total risky exposure converted to fiat

---

Counterparty

Field	Description
counterparty.address	Resolved AML address
service_category	exchange / mixer / darknet / scam / etc.
service_name	Name of service (if known)
risk_level	AML risk level
risk_score	Numeric risk score

---

Address Chain Analysis

Field	Description
hops	Number of hops between source and destination
path	Chain of intermediate addresses with attribution

---

Try it

POST/v1/transfers/{id}/recheck-exposure/

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.
}