---
title: "Address Risk Exposure"
method: POST
path: "/v0/address/risk-exposure"
tags: ["Chain Agnostic"]
---

# Address Risk Exposure

`POST /v0/address/risk-exposure`

Gets an address and returns risk exposure data.

## Request body

- RiskExposureAddressScanRequest
  - `address` string, required — The address to scan.
  - `metadata` ScanRequestMetadata
    - `domain` string — The full URL of the DApp or website that initiated the request, for cross-reference. Must use the https or http scheme and contain a valid hostname. Cannot contain JSON, braces, or other embedded data structures.
    - `non_dapp` boolean — Set to true when the request was not initiated by a dapp. Dapp requests should provide the `domain` field.
    - `account` RoutersChainAgnosticModelsRequestAccount
      - `account_id` string, required — Unique identifier for the account.
      - `account_creation_timestamp` string, date-time — Timestamp when the account was created.
      - `user_age` integer — Age of the user in years
      - `user_country_code` string — ISO country code of the user's location.
      - `account_addresses` string[] — List of all account addresses in different chains based on the CAIPs standard (https://github.com/ChainAgnostic/CAIPs). Ethereum mainnet example: eip155:1:0xab16a96d359ec26a11e2c2b3d8f8b8942d5bfcdb
    - `connection` RoutersChainAgnosticModelsRequestConnection
      - `user_agent` string — User agent string from the client's browser or application.
      - `ip_address` string, ipvanyaddress, required — IP address of the customer making the request. Both IPv4 and IPv6 addresses are supported.
      - `origin` string, uri — The full URL of the website that the request was directed to.
      - `walletconnect_name` string — WalletConnect session name, when the request originates from a WalletConnect session.
      - `walletconnect_description` string — WalletConnect session description, when the request originates from a WalletConnect session.
  - `chain` 'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'optimism' | 'aster' | 'polygon' | 'hyperevm' | 'hyperliquid' | 'lighter' | 'tron' | 'bitcoin' | 'solana' | 'polymarket', required — Supported chains for risk exposure
  - `proximity` 'overall' | 'ownership' | 'counterparty' | 'indirect' — Proximity ring relative to the scanned address (hops measured outward, the address itself is hop 0). `overall`: aggregated across all rings (default). `ownership`: hop 1 only. `counterparty`: hop 2 only. `indirect`: hop 3 and deeper.

## Response `200`

Success

- RiskProfilingResponse — Compliance risk exposure for an address, including an overall risk summary and exposure breakdown.
  - `address` string, required — The address being profiled.
  - `blocklist` boolean — Whether the address is explicitly blocklisted.
  - `name` string — Resolved entity name associated with the address, if known.
  - `risk_summary` RiskSummary, required — Aggregated compliance risk summary for the profiled address.
    - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
    - `total_usd` number, required — Total estimated USD exposure considered in the profile.
    - `total_malicious_exposure` number, required — Total estimated USD exposure associated with malicious risk.
  - `exposures` RiskExposure[] — Exposure breakdown by category.
    - `category` string, required — Exposure category name (e.g., sanctioned_entity, scam_investment_fraud, stolen_funds).
    - `amount_usd` number, required — Estimated exposure amount in USD for this category.
    - `percentage` number, required — Percentage of total exposure attributed to this category.
    - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
  - `proximity_level` 'overall' | 'ownership' | 'counterparty' | 'indirect' — Proximity ring relative to the scanned address (hops measured outward, the address itself is hop 0). `overall`: aggregated across all rings (default). `ownership`: hop 1 only. `counterparty`: hop 2 only. `indirect`: hop 3 and deeper.
  - `proximity` ProximityBreakdown — Exposure split into the three exclusive proximity rings. All three are always present; a ring with no exposure carries a zero risk summary and an empty list. Each ring is ring-relative — its `risk_summary.total_usd` and exposure percentages are scoped to that ring.
    - `ownership` ProximityRing, required — A single proximity ring's exposure: its own risk summary plus the category breakdown scoped to that ring.
      - `risk_summary` RiskSummary, required — Aggregated compliance risk summary for the profiled address.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
        - `total_usd` number, required — Total estimated USD exposure considered in the profile.
        - `total_malicious_exposure` number, required — Total estimated USD exposure associated with malicious risk.
      - `exposures` RiskExposure[], required — Exposure breakdown by category within this ring.
        - `category` string, required — Exposure category name (e.g., sanctioned_entity, scam_investment_fraud, stolen_funds).
        - `amount_usd` number, required — Estimated exposure amount in USD for this category.
        - `percentage` number, required — Percentage of total exposure attributed to this category.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
    - `counterparty` ProximityRing, required — A single proximity ring's exposure: its own risk summary plus the category breakdown scoped to that ring.
      - `risk_summary` RiskSummary, required — Aggregated compliance risk summary for the profiled address.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
        - `total_usd` number, required — Total estimated USD exposure considered in the profile.
        - `total_malicious_exposure` number, required — Total estimated USD exposure associated with malicious risk.
      - `exposures` RiskExposure[], required — Exposure breakdown by category within this ring.
        - `category` string, required — Exposure category name (e.g., sanctioned_entity, scam_investment_fraud, stolen_funds).
        - `amount_usd` number, required — Estimated exposure amount in USD for this category.
        - `percentage` number, required — Percentage of total exposure attributed to this category.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
    - `indirect` ProximityRing, required — A single proximity ring's exposure: its own risk summary plus the category breakdown scoped to that ring.
      - `risk_summary` RiskSummary, required — Aggregated compliance risk summary for the profiled address.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.
        - `total_usd` number, required — Total estimated USD exposure considered in the profile.
        - `total_malicious_exposure` number, required — Total estimated USD exposure associated with malicious risk.
      - `exposures` RiskExposure[], required — Exposure breakdown by category within this ring.
        - `category` string, required — Exposure category name (e.g., sanctioned_entity, scam_investment_fraud, stolen_funds).
        - `amount_usd` number, required — Estimated exposure amount in USD for this category.
        - `percentage` number, required — Percentage of total exposure attributed to this category.
        - `risk_level` 'Malicious' | 'Warning' | 'Benign' | 'High-Risk', required — The type of validation result.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/revisions/17c41f337b2e/schema)