AI-synthesized wallet intelligence report for any crypto address, paid per call via x402.
What it does
The wallet-report endpoint at intel.hugen.tokyo generates an AI-synthesized intelligence report for a given blockchain wallet address. It aggregates data from multiple sources to produce a risk score, risk level classification, a human-readable verdict, holdings summary, and actionable recommendations — all in a single API call. The endpoint accepts an optional `address` query parameter (returns demo data when omitted) and an optional `chain` parameter (defaults to "base").
This endpoint is part of the broader Intel API suite, which also offers token reports, yield reports, and contract audit summaries. Payment is handled via the x402 protocol: each call costs $0.50 in USDC on Base. Alternative access methods include an MCP gateway (mcp.hugen.tokyo), API-key-based access with a free $0.05 credit, or the `x402-pay` Python SDK for one-line integration without a wallet.
The response includes a numeric `risk_score` (e.g., 0–100), a `risk_level` label (e.g., "low"), a `classification` tag (e.g., "active_trader"), a natural-language `verdict`, holdings data (native ETH in wei, token transfer counts over 30 days), and a list of recommendations. The API is versioned at 0.1.0 and uses OpenAPI 3.1. Response schemas are not fully specified in the OpenAPI spec, so the exact output structure is inferred from the sample challenge response.
Capabilities
Use cases
- —Assess counterparty risk before transacting with an unknown wallet address
- —Automate wallet screening in a DeFi protocol or exchange onboarding flow
- —Build agent workflows that check wallet safety before executing trades
- —Generate human-readable wallet intelligence summaries for compliance dashboards
- —Screen wallet addresses in bulk for suspicious activity patterns
Fit
Best for
- —AI agents needing programmatic wallet risk assessment
- —DeFi applications requiring per-call due diligence without API key management
- —Developers who want a single endpoint replacing multiple data-source lookups
Not for
- —Full AML/KYC compliance requiring regulated data providers
- —Historical deep-dive forensics across dozens of chains (only 'base' chain default documented)
- —Free or high-volume bulk screening (each call costs $0.50)
Quick start
# Using the x402-pay Python SDK (no wallet needed)
pip install x402-pay
import x402_pay
r = x402_pay.get(
'https://intel.hugen.tokyo/intel/wallet-report?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base'
)
print(r.json())Example
Response
{
"verdict": "Active DeFi trader with 200+ transactions. No malicious activity detected. Primarily interacts with verified protocols.",
"holdings": {
"native_eth_wei": "1500000000000000000",
"token_transfers_30d": 47
},
"risk_level": "low",
"risk_score": 15,
"classification": "active_trader",
"recommendations": [
"Address appears safe for transactions"
]
}Endpoint
Quality
The endpoint is live (402 challenge captured) with an OpenAPI spec, clear pricing ($0.50 USDC on Base), and a sample response from the challenge. However, the response schema is not formally defined in the OpenAPI spec, documentation is minimal (auto-generated FastAPI docs only), and there are no detailed field descriptions or error-handling docs.
Warnings
- —Response schema is not formally specified in the OpenAPI definition — output structure is inferred from the x402 challenge sample only
- —API is version 0.1.0, suggesting early/experimental status
- —Only 'base' chain is documented as a default; supported chains are not enumerated
- —No dedicated documentation pages found beyond auto-generated /docs
Citations
- —The wallet-report endpoint costs $0.50 USDC on Base per callhttps://intel.hugen.tokyo/intel/wallet-report
- —API described as 'AI-synthesized due diligence reports for crypto assets. Multi-source aggregation + risk scoring + actionable verdicts.'https://intel.hugen.tokyo/docs
- —Alternative access via MCP gateway at mcp.hugen.tokyo, API key with $0.05 free credit, or x402-pay Python SDKhttps://intel.hugen.tokyo/intel/wallet-report
- —Endpoint accepts optional address and chain query parameters, defaults chain to 'base', returns demo data when address omittedhttps://intel.hugen.tokyo/docs