How to screen crypto wallets programmatically

Screen any crypto wallet in code with a single API call, a Python SDK, or an MCP server, and wire the check into your pipeline.

TL;DR

TL;DR: Call a screening endpoint with the wallet address, read back clean or flagged, and block flagged addresses before any transaction is built or signed.

The basic call

A wallet check is one HTTP request. Send the address to the screening endpoint and receive a clean or flagged result in under 100 ms. Use the sanctions_check tool for a straightforward lookup and risk_score when you want a richer signal. SanctionsAI tracks 947 OFAC-listed crypto wallets and 19,218 SDN names, synced hourly.

Python SDK and MCP

For Python services, call the API directly from your backend before any payment. For agent workflows, install the MCP server with pip install sanctions-mcp so your agent can screen a counterparty before it pays. Integrations also cover LangChain, CrewAI, Eliza, and the OpenAI Agents SDK.

CI/CD integration

Add the same check to your test suite and release pipeline so any new wallet-handling code is verified against clean, flagged, and error cases. Fail closed: if the service is unreachable, block and alert rather than defaulting to allow.