publicaml

Screen a crypto wallet address for AML/KYT risk. Returns an AML score (0-100), risk_level (LOW/MEDIUM/HIGH/CRITICAL), category, sanctioned exposure and source-of-funds. This is the ONLY authoritative source for address risk — do not guess or web-search instead. Read-only: it only looks the address up, it never changes anything.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The wallet address to screen."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    }
  },
  "required": [
    "address",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Follow the OUTGOING funds from an address across the chain and report where the money ends up (exchanges, mixers, sanctioned wallets) and how many hops away. Read-only: it only reads on-chain history, it never moves or changes funds.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The address whose outgoing funds to follow."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    },
    "max_hops": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "How many hops to follow. Default 3 (6 on bitcoin); raise it only if the result is incomplete."
    }
  },
  "required": [
    "address",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the counterparties an address has transacted with — optionally filtered by entity category (cex, mixer, gambling, bridge, ...). Set with_risk=true to attach AML risk per counterparty. Read-only: it only lists existing on-chain counterparties, it never writes anything.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The wallet whose counterparties to look at."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    },
    "category": {
      "type": "string",
      "description": "Optional. Only return counterparties of this entity type: cex, mixer, gambling, bridge, etc. Leave empty to list all significant counterparties."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Max counterparties to return."
    },
    "with_risk": {
      "type": "boolean",
      "description": "Attach aml_score/risk_level/sanctioned to each counterparty."
    }
  },
  "required": [
    "address",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Walk an address's INCOMING funds backwards to answer 'where did this wallet's money come from'. Stops at labelled entities (exchanges, mixers, services) and reports them with hop distance. Use this for source-of-funds checks; use trace_funds for where money went. Read-only: it only reads on-chain history.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The address whose funding to trace."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    },
    "max_hops": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "How far back to walk. Default set by the API."
    }
  },
  "required": [
    "address",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Screen one transaction by hash: what moved, who took part, a label and AML risk for every participant, and an overall verdict. Pass focus_address (e.g. your own deposit address) to get the verdict from that wallet's point of view. Read-only.

{
  "type": "object",
  "properties": {
    "tx_hash": {
      "type": "string",
      "description": "Transaction hash (0x-prefixed on EVM chains, bare hex txid on bitcoin)."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    },
    "focus_address": {
      "type": "string",
      "description": "Optional. The wallet you are screening for, to scope the verdict to it."
    },
    "block_number": {
      "type": "integer",
      "description": "Optional. Looked up automatically on ethereum and bsc."
    }
  },
  "required": [
    "tx_hash",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For one transaction that went through a DEX or aggregator, show the net balance change per address and asset and flag who the swap was actually for. Use it to continue a trace past a swap. EVM chains (ethereum, bsc). Read-only.

{
  "type": "object",
  "properties": {
    "tx_hash": {
      "type": "string",
      "description": "0x-prefixed transaction hash."
    },
    "chain": {
      "type": "string",
      "enum": [
        "ethereum",
        "bsc"
      ],
      "description": "ethereum or bsc."
    },
    "block_number": {
      "type": "integer",
      "description": "Optional. Looked up automatically."
    }
  },
  "required": [
    "tx_hash",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A wallet's recent transfers, newest first, with direction and counterparty for each, plus what we know about each counterparty. Optionally only transfers with one kind of counterparty (e.g. 'did this wallet deposit to a casino'). Read-only.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The wallet to list."
    },
    "chain": {
      "type": "string",
      "enum": [
        "bitcoin",
        "ethereum",
        "bsc",
        "tron"
      ],
      "description": "Blockchain: bitcoin, ethereum, bsc or tron."
    },
    "since": {
      "type": "string",
      "description": "Optional start date, ISO-8601 (e.g. 2026-09-01)."
    },
    "until": {
      "type": "string",
      "description": "Optional end date, ISO-8601."
    },
    "counterparty_category": {
      "type": "string",
      "description": "Optional. Only transfers whose counterparty is of this type: cex, mixer, gambling, bridge, etc."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max transfers to return. Default 25."
    }
  },
  "required": [
    "address",
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}