POST /v1/screen — Screening API Docs

POST/api/v1/screen

Screen a single crypto wallet address against all configured sanctions lists.

AnchorAPI provides informational screening signals based on aggregated public sanctions lists and risk databases, including a risk score and risk level. For any matched address, it reports the list or source name(s) and a flag status. It does not provide legal, compliance, or investment advice, does not assess the investment value of any digital asset, and does not replace your own compliance program. Risk levels and any suggested escalation are indicators only; the decision and action are yours. List and risk data may be incomplete, delayed, or inaccurate. Always implement your own independent review before acting on a result.

Request body

Field	Type	Description
address	string	Required. The wallet address to screen. EVM addresses are normalized to lowercase. Tron addresses must start with `T` followed by 33 base58 chars.
chain	string	Required. Chain slug. Supported: `ethereum` `bitcoin` `tron` `bsc` `arbitrum` `polygon` `litecoin` `monero` and others. Use full names, not ticker symbols.

Response fields

Field	Type	Description
address	string	Normalized address that was screened.
chain	string	Chain as provided in the request.
score	number	Risk score 0–100. Max of all matched label scores. 0 means no match.
level	string	`CLEAN_NO_MATCH` `MEDIUM` `HIGH` `CRITICAL` — `LOW` is reserved for future use and not currently produced by any active label.
labels	array	Risk signals. Each item has `label` `source` `source_ref` `added_at`. Empty array if no match.
data_freshness	object	Map of source → `{ last_updated, age_seconds }`. Shows when each source was last ingested.
scoring_version	string	Scoring algorithm version, e.g. `v1.0`. Included for auditability.
_disclaimer	string	Compliance disclaimer. Suitable for logging alongside results.

Code examples

curl https://anchorapi.dev/api/v1/screen \
  -H "Authorization: Bearer $SCREENING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c",
    "chain": "ethereum"
  }'

Sample response — CRITICAL match

{
  "address": "0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c",
  "chain": "ethereum",
  "score": 100,
  "level": "CRITICAL",
  "labels": [
    {
      "label": "sanctions",
      "source": "OFAC_SDN",
      "source_ref": "TORNADO_CASH",
      "added_at": "2022-08-08T00:00:00.000Z"
    }
  ],
  "data_freshness": {
    "OFAC_SDN": {
      "last_updated": "2026-05-26T04:07:00.000Z",
      "age_seconds": 127
    },
    "EU_CONSOLIDATED": {
      "last_updated": "2026-05-26T00:23:00.000Z",
      "age_seconds": 14027
    },
    "UK_CONSOLIDATED": {
      "last_updated": "2026-05-26T00:37:00.000Z",
      "age_seconds": 13187
    },
    "COMMUNITY_BADLIST": {
      "last_updated": "2026-05-25T18:13:00.000Z",
      "age_seconds": 36227
    }
  },
  "scoring_version": "v1.0",
  "_disclaimer": "Informational screening only. This result reports which sanctions or risk lists, if any, the address matched at the time of query, together with an informational risk score and level. It is not legal, compliance, or investment advice, not a determination of legality, sanctions status, or value, and may be incomplete or delayed. The risk level and any suggested escalation are indicators only — you decide and act. You are responsible for complying with the laws of your jurisdiction. Verify independently before acting."
}

Sample response — clean address

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "ethereum",
  "score": 0,
  "level": "CLEAN_NO_MATCH",
  "labels": [],
  "data_freshness": { ... },
  "scoring_version": "v1.0",
  "_disclaimer": "..."
}