POST /v1/screen/batch — Screening API Docs

POST/api/v1/screen/batch

Screen up to 100 addresses in a single request. Returns results in the same order as the input array.

The Screening API provides screening signals based on aggregated public data. It does not replace your compliance program. Risk scores and labels may be incomplete, delayed, or incorrect. Always implement your own review processes before acting on screening results.

Request body

Field	Type	Description
addresses	array	Required. Non-empty array of `{ address, chain }` objects. Hard cap: 100 items.
addresses[].address	string	Wallet address. Same format rules as single screen.
addresses[].chain	string	Chain slug. Same values as single screen.

Quota accounting: A batch of N addresses consumes N from your monthly quota — the same as N individual calls. A batch of 100 costs 100 quota units.

Response

Field	Type	Description
results	array	Array of screening results in input order. Each item is identical in shape to the single `/v1/screen` response.
summary.total	number	Total addresses screened.
summary.clean	number	Count with level CLEAN_NO_MATCH.
summary.low / medium / high / critical	number	Count per risk level. Useful for dashboards and alerting.

Code examples

curl https://anchorapi.dev/api/v1/screen/batch \
  -H "Authorization: Bearer $SCREENING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      { "address": "0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c", "chain": "ethereum" },
      { "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf", "chain": "bitcoin" },
      { "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "chain": "tron" }
    ]
  }'

Sample response

{
  "results": [
    {
      "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": { ... },
      "scoring_version": "v1.0",
      "_disclaimer": "..."
    },
    {
      "address": "1a1zp1ep5qgefi2dmptftl5slmv7divf",
      "chain": "bitcoin",
      "score": 0,
      "level": "CLEAN_NO_MATCH",
      "labels": [],
      "data_freshness": { ... },
      "scoring_version": "v1.0",
      "_disclaimer": "..."
    }
  ],
  "summary": {
    "total": 2,
    "clean": 1,
    "low": 0,
    "medium": 0,
    "high": 0,
    "critical": 1
  }
}