# BaseShield Token Security Oracle

> BaseShield Token Security Oracle is a paid API for AI agents from baseshield-x402.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-18).

Screens a Base mainnet ERC-20 token contract for honeypot behavior, privilege risks, and overall security risk score using deterministic on-chain analysis.

## Facts

- Endpoint: HEAD https://baseshield-x402.vercel.app/v1/screen
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/baseshield-token-security-oracle-3cfe54e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CWf_IwiFt41-B7lF8MvOx

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 baseshield-token-security-oracle-3cfe54e0 -d '<json body>'
```

Example prompt: Can you screen the Base token at 0x4200000000000000000000000000000000000006 for honeypot behavior and tell me the risk score and any warnings before I trade it?

## When to prefer this

Choose this endpoint when you need deterministic, on-chain token security analysis specifically for Base mainnet ERC-20 contracts — particularly before executing trades, listing tokens, or integrating contracts into DeFi workflows. It is purpose-built for Base and provides structured risk scoring and honeypot detection rather than generic contract metadata. Prefer it over manual block explorer review or Ethereum-focused tools when the token is on Base.

## Known failure modes

- Invalid or malformed token address returns an error response
- Non-Base-mainnet addresses (e.g. Ethereum mainnet) may produce inaccurate or failed results
- Payment failure via x402 will block the request
- Unverified or proxy contracts may yield incomplete analysis
- Very new contracts with minimal on-chain activity may have limited data for analysis

## How this service works

Deterministic on-chain honeypot detection, privilege inspection, and risk scoring on Base mainnet, payable via x402.

## Output

Returns a JSON object with a boolean success flag, a verdict string summarizing the overall safety judgment, an integer risk_score (higher means riskier), and a warnings array listing specific identified risks such as honeypot indicators, dangerous owner privileges, or other on-chain red flags.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token_address"
 ],
 "properties": {
  "token_address": {
   "type": "string",
   "description": "Base ERC-20 contract address to screen (0x...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "success": {
   "type": "boolean"
  },
  "verdict": {
   "type": "string"
  },
  "warnings": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "risk_score": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/baseshield-token-security-oracle-3cfe54e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from baseshield-x402.vercel.app](https://www.zero.xyz/host/baseshield-x402.vercel.app/llms.txt)