# Bitcoin Address AML/Compliance Risk Scorer

> Bitcoin Address AML/Compliance Risk Scorer is a paid API for AI agents from tinkrr-api.tinkrr.workers.dev, paid per call via x402, $0.009/call, status unknown (last checked 2026-09-15).

Returns an AML/compliance risk score (0–100) with signals and tier classification for a given Bitcoin address

## Facts

- Endpoint: GET https://tinkrr-api.tinkrr.workers.dev/btc/address/risk
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-address-aml-compliance-risk-scorer-534745d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gGQsEJN1umcxWX6C4M9br

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bitcoin-address-aml-compliance-risk-scorer-534745d2
```

Example prompt: Can you run an AML compliance risk check on Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf Mo and tell me the risk score, tier, and any signals that triggered?

## When to prefer this

Use this endpoint when you need a fast, low-cost AML/compliance risk score for individual Bitcoin addresses — particularly useful for compliance workflows, transaction screening, or onboarding checks where you need a scored signal with tier classification rather than just a raw blockchain lookup.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error
- Address not indexed or unrecognized by the scoring engine returns null or empty signals
- Network timeout from the Cloudflare Worker returns a 5xx error
- Missing required address parameter returns a 400 bad request
- Payment not provided or invalid x402 payment header results in 402 Payment Required

## How this service works

Bitcoin address AML/compliance risk score 0-100 with signals

## Output

Returns a JSON object containing the Bitcoin address, a numeric risk score from 0 to 100, a risk tier (e.g. low/medium/high), an array of AML risk signals that contributed to the score, address metadata, and a legal disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "description": "Bitcoin address (bc1..., 1..., 3...)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "schema": {
     "type": "object",
     "properties": {
      "risk": {
       "type": "object",
       "properties": {
        "tier": {
         "type": "string"
        },
        "score": {
         "type": "number"
        },
        "signals": {
         "type": "array"
        }
       }
      },
      "address": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      },
      "addressInfo": {
       "type": "object"
      }
     }
    },
    "example": {
     "risk": {
      "tier": "low",
      "score": 12,
      "signals": [
       "no_elevated_signals"
      ]
     },
     "address": "bc1qexample...",
     "addressInfo": {
      "type": "p2wpkh",
      "txCount": 5,
      "balance_sats": 120000
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-address-aml-compliance-risk-scorer-534745d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tinkrr-api.tinkrr.workers.dev](https://www.zero.xyz/host/tinkrr-api.tinkrr.workers.dev/llms.txt)