# Wallet & Token On-Chain Risk Scorer

> Wallet & Token On-Chain Risk Scorer is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-26).

Returns a behavioral on-chain risk score (0–100) for a wallet or token contract address, incorporating activity, age, counterparty concentration, asset diversity, large-transfer share, and smart-money score.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/wallet_token_risk?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallet-token-on-chain-risk-scorer-d59ac161
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_njGkIvHqkDbP2clPODygx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wallet-token-on-chain-risk-scorer-d59ac161 -d '<json body>'
```

Example prompt: Score the on-chain risk of the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — I want to know how risky it looks behaviorally, including its smart-money score, using up to 50 transfers sampled per direction.

## When to prefer this

Choose this endpoint when you need a fast, affordable behavioral risk score for a specific wallet or token contract on EVM chains (Ethereum, Arbitrum, Base, Polygon, Optimism) and do NOT need sanctions screening or honeypot detection. Ideal for DeFi due diligence, counterparty vetting, or token pre-trade checks where pay-per-call pricing ($0.05 USDC) beats subscription-based alternatives. Prefer alternatives if you require OFAC/sanctions compliance or honeypot-specific analysis.

## Known failure modes

- Invalid or malformed address (not 0x-prefixed, not 42 chars) returns a validation error
- Unsupported chain key returns an error — only eth, arb, base, polygon, opt are valid
- Insufficient on-chain data for very new or inactive addresses may yield incomplete scores
- Payment failure via x402 (insufficient USDC balance on Base) blocks the call
- transfer_limit out of range (less than 1 or greater than 100) returns a parameter error

## How this service works

Wallet & Token Risk Score: Behavioral on-chain risk score (0-100) for a wallet or token contract: activity, age, counterparty concentration, asset diversity and large-transfer share, plus a smart-money score for wallets. Not sanctions or honeypot screening. Pay per call in USDC on Base via x402 — POST https://x402.freeq.one/tools/wallet_token_risk.

## Output

A structured JSON response containing a behavioral risk score from 0 to 100 for the queried address, plus sub-scores and signals including activity level, wallet age, counterparty concentration, asset diversity, large-transfer share, and (for wallet subjects) a smart-money score. Higher scores indicate greater risk.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "example": "eth",
   "description": "Chain key: eth, arb, base, polygon, opt"
  },
  "address": {
   "type": "string",
   "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "description": "Wallet address (subject wallet) or token contract address (subject token), 0x-prefixed, 42 chars"
  },
  "subject": {
   "enum": [
    "wallet",
    "token"
   ],
   "type": "string",
   "example": "wallet",
   "description": "What to assess: wallet (default) or token"
  },
  "transfer_limit": {
   "type": "integer",
   "example": 50,
   "description": "Max transfers sampled per direction, 1-100 (default 50)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallet-token-on-chain-risk-scorer-d59ac161/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)