Configure AML - Finrock

MCP scope: dac.funds (not available to AI connectors yet) Finrock’s AML screening integration lets you automatically flag or freeze transactions and addresses that exceed your configured risk threshold. This endpoint allows you to enable AML screening for your sub-account, select your preferred provider, supply your provider API key, and specify the exact risk levels and transaction directions to screen. Once configured, every deposit and/or withdrawal is checked in real time against the provider’s database of known illicit and high-risk addresses.

AML Providers and Risk Levels

Provider	Supported Risk Levels
Chainalysis	`SEVERE`, `HIGH`, `MEDIUM`, `LOW`
Cipertrace	`SEVERE`, `HIGH`, `MEDIUM`, `LOW`
AMLBot	`SEVERE`, `HIGH`, `MEDIUM`, `LOW`

Body Parameters

Method: POST URL: https://api.finrock.io/dac/v1/aml

string

default:"Chainalysis"

required

The AML provider to use for screening. Must be one of Chainalysis, Cipertrace, or AMLBot.

string

required

The API key issued by your chosen AML provider. Finrock uses this token to authenticate requests to the provider on your behalf.

string

default:"SEVERE, HIGH"

required

A comma-separated list of risk levels, in upper case, that trigger a freeze or block. For example: SEVERE, HIGH or SEVERE, HIGH, MEDIUM. Transactions from addresses flagged at any listed risk level will be held.

boolean

default:"true"

required

Set to true to enable AML screening on incoming deposits. When enabled, Finrock checks the sender address against the provider’s dataset before crediting the deposit.

boolean

default:"true"

required

Set to true to enable AML screening on outgoing withdrawals. When enabled, Finrock checks the destination address before releasing the withdrawal.

curl --request POST \
     --url https://api.finrock.io/dac/v1/aml \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "provider": "Chainalysis",
  "aml_token": "your-chainalysis-api-key",
  "aml_risk_levels": "SEVERE, HIGH",
  "aml_deposit": true,
  "aml_withdrawal": true
}'

Response

A 200 response confirms that the AML settings have been saved and are now active.

integer

1000 when the AML settings were saved successfully.

string | null

null on success.

string | null

Additional information, if any. null on success.

{
  "code": 1000,
  "error": null,
  "info": null
}

Once AML screening is active, deposits or withdrawals from addresses flagged at your selected risk levels will be automatically frozen. Ensure your aml_risk_levels threshold aligns with your compliance policy before enabling in production.