From obul-crypto
USE THIS SKILL WHEN: the user wants blockchain address compliance screening, AML risk assessment, address labeling, KYA (Know Your Address) reports, or sanctions checking for Ethereum, Tron, BSC, and other chains.
How this skill is triggered — by the user, by Claude, or both
Slash command
/obul-crypto:blocksecThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
BlockSec provides blockchain address compliance and risk screening APIs, powered by MetaSleuth and Phalcon Compliance
BlockSec provides blockchain address compliance and risk screening APIs, powered by MetaSleuth and Phalcon Compliance intelligence. Services include address labeling (identifying exchanges, protocols, and known entities), light risk screening for quick AML checks, and deep risk screening for comprehensive KYA (Know Your Address) compliance reports. BlockSec is a reputable Web3 security firm trusted by major protocols. Through the Obul proxy, each request is paid individually with no BlockSec account or API key required.
All requests use the obulx CLI, which handles proxy routing and authentication automatically.
Install and log in (one-time setup):
npm install -g @obul.ai/obulx
obulx login
Base URL: https://x402.blocksec.ai
Retrieve canonical entity names and categories for a blockchain address. Identifies exchanges, protocols, funds, and other labeled entities. Useful for understanding who owns or controls an address.
Pricing: $0.10
obulx "https://x402.blocksec.ai/label/eth/0x463452c356322d463b84891ebda33daed274cb40"
Response: JSON object with entity name (e.g., "Binance"), category (e.g., "Exchange"), subcategories, and confidence score. Returns empty labels for unlabeled addresses.
Perform a quick compliance risk assessment for a wallet address. Returns a risk score and basic AML screening results including interactions with sanctioned or suspicious wallets. Ideal for fast pre-transaction checks.
Pricing: $0.20
obulx "https://x402.blocksec.ai/screen/light/eth/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
Response: JSON object with risk score (0-100), risk level (low/medium/high/critical), sanctioned entity interactions, suspicious activity flags, and a brief risk summary.
Deliver a comprehensive KYA (Know Your Address) report with detailed compliance insights, transaction flow analysis, fund source tracing, and entity relationship mapping. This is the most thorough screening option for due diligence.
Pricing: $1.00
obulx "https://x402.blocksec.ai/screen/deep/tron/TYXqLb9ZyAeJeTFkt3Tx7kNyc3HufjvnMs"
Response: JSON object with comprehensive KYA report including risk score, detailed risk breakdown, fund source analysis, transaction flow mapping, sanctioned entity exposure, counterparty analysis, and compliance recommendations.
| Endpoint | Price | Purpose |
|---|---|---|
GET /label/{chain}/{address} | $0.10 | Address labeling (entity name, category) |
GET /screen/light/{chain}/{address} | $0.20 | Quick AML risk screening with risk score |
GET /screen/deep/{chain}/{address} | $1.00 | Comprehensive KYA compliance report |
GET /label/eth/{address} | $0.10 | Ethereum address labels |
GET /label/bsc/{address} | $0.10 | BSC address labels |
GET /label/tron/{address} | $0.10 | Tron address labels |
GET /health | $0.00 | Server health check |
/label first ($0.10) to identify the entity. Only escalate to screening
if the address is unlabeled or suspicious./screen/light endpoint ($0.20) is sufficient for most
pre-transaction compliance checks./screen/deep endpoint ($1.00) provides comprehensive
analysis but is significantly more expensive. Use it for large transactions or regulatory requirements.| Error | Cause | Solution |
|---|---|---|
402 Payment Required | Payment not processed or insufficient | Verify your account has sufficient balance at my.obul.ai. Run obulx login if not authenticated. |
400 Bad Request | Invalid chain or address format | Ensure the chain parameter is valid (eth, bsc, tron, etc.) and the address is correctly formatted. |
404 Not Found | Unsupported chain | Verify the chain is in the supported list: eth, bsc, tron, polygon, arbitrum, base, optimism. |
422 Unprocessable Entity | Valid request but cannot process | The address format may not match the specified chain (e.g., 0x address for Tron). |
429 Too Many Requests | Rate limit exceeded | Add a short delay between requests and avoid rapid-fire calls. |
500 Internal Server Error | Upstream BlockSec service issue | Wait a few seconds and retry. If persistent, the service may be experiencing downtime. |
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub polymerdao/pay-plugin --plugin obul-crypto