langchain-chainanalyzer

LangChain tools for ChainAnalyzer blockchain AML screening. Let an agent screen a crypto address before it credits a deposit, sends a payout or onboards a counterparty — across Bitcoin, Ethereum and EVM L2s, Solana, TRON, XRP and Kaia (12 chains).

Pay per call in USDC on Base via x402 — no account, no signup — or use a ChainAnalyzer API key.

Install

pip install langchain-chainanalyzer            # API-key mode
pip install "langchain-chainanalyzer[x402]"    # + pay per call in USDC (x402)

Use

from langchain.agents import create_agent
from langchain_chainanalyzer import ChainAnalyzerToolkit

tools = ChainAnalyzerToolkit(max_usd_per_call="1.00").get_tools()
agent = create_agent("openai:gpt-5-mini", tools=tools)

result = await agent.ainvoke({"messages": [{
    "role": "user",
    "content": "A user wants to deposit from 0x5227f603c1ee34ce3c06efe6477003bdfccb2f8c (Ethereum). "
               "Screen it (sanctions first, then hack exposure) and answer CREDIT, REVIEW or HOLD with reasons.",
}]})

Each tool also works on its own: await tools[1].ainvoke({"address": "0x5227f603c1ee34ce3c06efe6477003bdfccb2f8c"}).

Auth and safety

• Results are automated screening signals, not a legal determination. Hack exposure is a lower-bound taint over published incidents only; no match (or no freeze) is not proof that funds are clean. Keep a human in the loop.
• Failed requests are not charged. Live routes and prices: https://chain-analyzer.com/x402/api/discover
• Also available: MCP server chainanalyzer-mcp and Vercel AI SDK tools @chainanalyzer/ai-sdk.

MIT License