fluxa

Address risk

Query the KYT (know-your-transaction) risk score of any on-chain address. Use it to screen a customer's withdrawal or deposit address before you act on it. The score reuses the platform's configured risk engine.

The risk result

  • Name
    address
    Type
    string
    Description

    The address that was scored.

  • Name
    chain
    Type
    string
    Description

    The chain it was scored on (echoes your chain query, if any).

  • Name
    score
    Type
    integer
    Description

    Risk score from 0 to 100.

  • Name
    level
    Type
    string
    Description

    Coarse band: low (<20), medium (20–49), high (50–79), or severe (≥80).

  • Name
    categories
    Type
    array
    Description

    Risk tags, e.g. ["sanctions", "mixer"]. May be empty.

With the built-in local engine, unknown addresses score low (fail-open). A configured external engine returns real scores. If no risk engine is available, the endpoint returns 404 risk_unavailable.

GET/api/v1/addresses/:address/risk

Score an address

Signed locally — your secret stays in this browser and is never sent or stored.

No keys yet? Create an API key pair in the merchant portal — the secret is shown only once. Open the merchant portal →

Score an on-chain address. Pass the address in the path and, optionally, the chain as a query parameter.

Optional attributes

  • Name
    chain
    Type
    string
    Description

    Chain code to score against, e.g. usdt_erc20.

Request

GET
/api/v1/addresses/:address/risk
curl -G "$BASE/api/v1/addresses/0xAbc.../risk" \
  -d chain=usdt_erc20 \
  -H "X-Api-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

Response

{
  "address": "0xAbc...",
  "chain": "usdt_erc20",
  "score": 12,
  "level": "low",
  "categories": []
}