curl -H "X-apikey: <key>" \
  "https://api.alpha-aml.com/api/report/wallet?address=0x7f367cc41522ce07553e823bf3be79a889debe1b&chain=ETH" \
  -o aml-report.pdf

curl -H "X-apikey: <key>" \
  "https://api.alpha-aml.com/api/report/wallet?address=TXyz1234567890abcdefgh&chain=TRON" \
  -o aml-report.pdf

curl -H "X-apikey: <key>" \
  "https://api.alpha-aml.com/api/report/txhash?txHash=0x3421c1fb88ab5962400c904f874ed3ba850c2121e2216433c6c8034872b48d9f&chain=ETH"

# disambiguate a multi-transfer tx by event log index
curl -H "X-apikey: <key>" \
  "https://api.alpha-aml.com/api/report/txhash?txHash=0x97ee11e7360dfff10a7e7f5878a5efe1bd008e913111f8224212bc5da6366489&chain=ETH&event_index=63"

curl -H "X-apikey: <key>" \
  "https://api.alpha-aml.com/api/report/txhash?txHash=e512d7f0eeeba031d9442a0ae8673a2ea1ede7d2dfe943cf86fcc0528dc4c937&chain=TRON"

curl -H "X-apikey: <key>" -A "your-app/1.0" \
  "https://api.alpha-aml.com/api/engine/report-v1?address=0x08723392ed15743cc38513c4925f5e6be5c17243&chain=ethereum"

{
  "report": {
    "report_id": "rpt_eee33b79440cf7f7e1ac2e491e8fd217",
    "status": "complete",
    "coverage": "full",
    "is_final": true,
    "preliminary": false,
    "model_version": "4.3.0-da50fad0",
    "data_version": "3780a61d",
    "generated_at_utc": "2026-10-21T16:36:25Z",
    "data_as_of": {
      "chain_head_block": 26242211,
      "chain_head_utc": "2026-10-21T16:36:11Z",
      "graph_block": 26238303,
      "graph_utc": "2026-10-21T03:32:59Z",
      "graph_lag_blocks": 3908,
      "graph_lag_seconds": 46992,
      "exposure_checked_to_chain_head": true,
      "note": "Activity is current to chain_head_block; traced exposure is current to graph_block. Value received after graph_block from addresses already known to be exposed is checked at request time and reported under risk_factors.post_graph_exposure; deeper paths opened by such a transfer are resolved at the next graph pass."
    }
  },
  "wallet": {
    "address": "0x08723392ed15743cc38513c4925f5e6be5c17243",
    "blockchain": "ETHEREUM",
    "description": "Lazarus Group Ronin Hack ETH (OFAC SDN - May 6 #2)",
    "entity_tag": "Lazarus Group"
  },
  "risk_assessment": {
    "score": 100.0,
    "score_max": 100,
    "risk_level": "VERY HIGH RISK",
    "blacklisted": true,
    "blacklist_note": "Address found in 6 reference list(s)",
    "risk_sources_count": 11,
    "risk_sources_note": "flagged connected addresses",
    "score_zones": [
      {
        "label": "Very Low",
        "range_min": 0,
        "range_max": 25,
        "min_inclusive": 0.0,
        "max_exclusive": 26.0
      },
      {
        "label": "Low",
        "range_min": 26,
        "range_max": 40,
        "min_inclusive": 26.0,
        "max_exclusive": 41.0
      }
    ]
  },
  "token_balances": [
    {
      "token": "ETH",
      "contract_address": "",
      "balance": 3.2972312
    }
  ],
  "wallet_statistics": {
    "received_transactions_count": 13,
    "sent_transactions_count": 4,
    "total_transactions_count": 17,
    "first_transaction_utc": "2022-05-04T07:32:25Z",
    "last_transaction_utc": "2026-08-10T05:51:59Z",
    "wallet_age_days": 1631,
    "status": "ACTIVE",
    "stablecoin_inflow_usd": 0.0,
    "stablecoin_outflow_usd": 0.0,
    "stablecoin_turnover_usd": 0.0
  },
  "funded_by_entity_type_distribution": [
    {
      "label": "Smart contract",
      "percentage": 66.7,
      "category_code": "unknown",
      "category_label": "Unknown attribution",
      "entity_class": "",
      "risk_bearing": false,
      "source": "",
      "transfer_count": 2,
      "denominator": "sampled_inflow_transfers",
      "denominator_value": 3.0,
      "value": 2.0,
      "share_pct_exact": 66.66667
    },
    {
      "label": "Unnamed active wallet",
      "percentage": 33.3,
      "category_code": "unknown",
      "category_label": "Unknown attribution",
      "entity_class": "",
      "risk_bearing": false,
      "source": "",
      "transfer_count": 1,
      "denominator": "sampled_inflow_transfers",
      "denominator_value": 3.0,
      "value": 1.0,
      "share_pct_exact": 33.33333
    }
  ],
  "funding_scope": {
    "describes": "address_inflows",
    "per_transfer": false,
    "max_transfers_sampled": 200000,
    "window_seconds": 18000000,
    "anchored_to": "address_last_activity",
    "denominator": "sampled_inflow_transfers",
    "denominator_value": 3.0,
    "note": "Shares describe this address's sampled inflows, NOT the funds of any single transfer. A per-transfer origin breakdown is not available from this endpoint."
  },
  "risk_factors": {
    "blacklists": {
      "status": "Flagged",
      "score": 100,
      "detail": "Address found in 6 reference list(s)"
    },
    "reported_connected_addresses": [
      {
        "severity": "Severe",
        "score": 100,
        "address_count": 3,
        "status": "Reported",
        "addresses": [
          {
            "address": "0x08723392ed15743cc38513c4925f5e6be5c17243",
            "hops": 0
          },
          {
            "address": "0x098b716b8aaf21512996dc57eb0615e2383e2f96",
            "hops": 1
          }
        ]
      }
    ],
    "factors": [
      {
        "kind": "blacklist",
        "category_code": "sanctions",
        "category_label": "Sanctions designation",
        "entity_class": "endpoint",
        "list_type": "sanctions",
        "source": "OFAC",
        "entity": "",
        "jurisdiction": "",
        "severity": 100,
        "directness": "direct",
        "hops": 0,
        "share_pct": 100.0,
        "amount_usd": null,
        "denominator": "not_applicable",
        "denominator_value_usd": null,
        "candidate_points": 100.0,
        "applied": true,
        "effective_points": 100.0,
        "exclusion_reason": "",
        "source_addresses": [
          "0x08723392ed15743cc38513c4925f5e6be5c17243"
        ],
        "source_count": 1,
        "contribution_points": 100.0,
        "detail": "Address is named directly in OFAC (sanctions)"
      },
      {
        "kind": "blacklist",
        "category_code": "sanctions",
        "category_label": "Sanctions designation",
        "entity_class": "endpoint",
        "list_type": "sanctions",
        "source": "ofac_sanctions_list",
        "entity": "",
        "jurisdiction": "",
        "severity": 100,
        "directness": "direct",
        "hops": 0,
        "share_pct": 100.0,
        "amount_usd": null,
        "denominator": "not_applicable",
        "denominator_value_usd": null,
        "candidate_points": 100.0,
        "applied": true,
        "effective_points": 100.0,
        "exclusion_reason": "",
        "source_addresses": [
          "0x08723392ed15743cc38513c4925f5e6be5c17243"
        ],
        "source_count": 1,
        "contribution_points": 100.0,
        "detail": "Address is named directly in ofac_sanctions_list (sanctions)"
      }
    ],
    "score_breakdown": {
      "direct_listing": 100.0,
      "counterparty": 100.0,
      "indirect_exposure": 0.75,
      "concentration": 0.0,
      "post_graph_exposure": 0.0,
      "activity_baseline": 16.88,
      "entity_penalty": 75,
      "geo_penalty": 19,
      "recognised_entity_credit_applied": true,
      "counterparty_is_rated_service": false,
      "treated_as_service": true,
      "service_basis": "named service",
      "score": 100.0,
      "degraded_lookups": [],
      "decided_by": "direct_listing",
      "decided_by_category": "sanctions",
      "decided_by_list_type": "sanctions",
      "note": "Components are not additive; the score is the strongest of them. decided_by names the one that set it; factors marked applied=false were found and reported but did not change the score."
    },
    "post_graph_exposure": {
      "status": "none",
      "tainted_usd": 0.0,
      "share_of_received_pct": 0.0,
      "transfer_count": 0,
      "source_count": 0,
      "senders_examined": 0,
      "source_addresses": [],
      "category_code": "",
      "from_block": 0,
      "last_block": 0,
      "last_utc": "",
      "window": "after graph_block, to chain_head_block",
      "note": "Hop-1 only, limited to senders the last graph pass had already judged, to the largest senders_examined of them by value, and to priced assets. It is therefore a floor on exposure in this window, not the whole of it; the next pass traces the rest. An empty result means the window was examined and nothing matched."
    },
    "excluded_below_threshold": {
      "tainted_usd": 0.0,
      "source_count": 0,
      "rule": "absolute_traced_value_usd",
      "note": "Traced value below the materiality threshold. The test is on the absolute USD figure, not on the share. Such exposure is reported here and still contributes, but on the conservative curve."
    }
  },
  "entity_attribution": {
    "attribution": "resolved",
    "note": "This address is attributed to the entity below.",
    "entity": {
      "kind": "company",
      "id": "Lazarus Group",
      "name": "Lazarus Group",
      "risk_score": 75,
      "jurisdictions": [
        "North Korea",
        "South Korea",
        "United States"
      ],
      "reasons": [
        {
          "source": "geo_risk",
          "weight": 75,
          "detail": "jurisdiction North Korea"
        }
      ]
    },
    "address_label": {
      "label": "Lazarus Group Ronin Hack ETH (OFAC SDN - May 6 #2)",
      "company": "Lazarus Group",
      "country": "North Korea, South Korea, United States, Japan, China, Malaysia, Indonesia, India, Bangladesh, Philippines, United Kingdom, Germany, France, Russia, Australia, Kuwait",
      "recognised_operator": false,
      "labelled_in_registry": true,
      "behaves_as_service": true,
      "service_basis": "named service"
    }
  },
  "jurisdiction_risk": {
    "jurisdictions": [
      {
        "country": "North Korea",
        "tier": "high_risk",
        "weight": 75
      },
      {
        "country": "South Korea",
        "tier": "not_listed",
        "weight": 0
      },
      {
        "country": "United States",
        "tier": "not_listed",
        "weight": 0
      }
    ],
    "listed_count": 1,
    "total_linked_count": 16,
    "truncated": "showing 8 of 16, highest-weighted first",
    "applied_penalty_points": 19,
    "basis": "North Korea is a high-risk jurisdiction",
    "note": "Jurisdiction is a contributing factor, not a verdict. An empty list means no jurisdiction was found for this address."
  },
  "related_entities": {
    "counterparties": [
      {
        "address": "0x098b716b8aaf21512996dc57eb0615e2383e2f96",
        "direction": "received_from",
        "name": "Sanctions",
        "company": "",
        "country": "",
        "category_code": "issuer_freeze",
        "category_label": "Issuer freeze",
        "entity_class": "endpoint",
        "severity": 90,
        "recognised": false,
        "value_usd": 37785900.0
      }
    ],
    "named_counterparty_count": 1,
    "risk_bearing_count": 1,
    "recognised_count": 1,
    "note": "Named counterparties only; anonymous ones are not listed."
  }
}

{ "error": "Too Many Requests", "message": "Per-user rate limit exceeded", "request_id": "27905ac8-79f1-4e88-bc5d-d87c4ff88ed7" }

// Bad address format
{ "error": { "code": "INVALID_ADDRESS", "field": "address", "message": "Not a valid address: zzz" } }

// TRON address on an EVM chain
{ "error": { "code": "UNSUPPORTED_CHAIN", "field": "sender", "message": "Unsupported or mismatched chain: eth" } }

// Ambiguous transaction
{ "error": { "code": "MULTIPLE_TRANSFERS", "message": "Transaction has 0 native and 25 token transfer(s) — pass event_index / token_contract / sender / recipient to pick one" } }

// Unknown hash
{ "error": { "code": "UNKNOWN_HASH", "field": "txHash", "message": "Transaction not found: 0x…" } }