# TokenGuard ERC-20 Wallet Safety Check

> TokenGuard ERC-20 Wallet Safety Check is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Performs a heuristic safety and rug-pull risk check on an ERC-20 wallet address using public RPC data, returning flags, balances, transaction count, and activity level.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/wallet
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-erc-20-wallet-safety-check-a7446d19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oQ9dleIbluIYNH12LiPmG

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 tokenguard-erc-20-wallet-safety-check-a7446d19 -d '<json body>'
```

Example prompt: Can you run a rug-pull safety check on the wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aec9b and tell me if there are any suspicious flags, what the ETH and USDC balances are, and whether it's a contract or a regular wallet?

## When to prefer this

Use this endpoint when you need a quick, low-cost ($0.005 USDC) heuristic safety signal on an ERC-20 wallet or token address before interacting with it — especially for DeFi due diligence, bot-driven token screening, or pre-trade risk checks. Prefer this over full audit services when speed and cost matter more than exhaustive analysis.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Public RPC rate limiting may cause timeouts or stale data
- Address with no on-chain history may return zeroed balances and empty flags
- Network congestion may delay RPC response
- Heuristics may produce false positives or miss sophisticated rug pulls

## How this service works

Wallet intelligence: EOA-vs-contract, ETH+USDC balance, tx count, activity/risk flags.

## Output

Returns a JSON object with an array of heuristic safety flags (empty if none), the total transaction count, ETH balance, USDC balance, a boolean indicating if the address is a smart contract, and an activity level string (e.g. 'active', 'inactive').

## Example request

```json
{
 "chain": "base",
 "address": "0x1234567890123456789012345678901234567890"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string",
   "description": "Chain (default base)"
  },
  "address": {
   "type": "string",
   "description": "Wallet/contract address (0x…40 hex)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flags": [],
  "tx_count": 30,
  "eth_balance": 0.02,
  "is_contract": false,
  "usdc_balance": 0.35,
  "activity_level": "active"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-erc-20-wallet-safety-check-a7446d19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)