# Token Portfolio Risk Scanner

> Token Portfolio Risk Scanner is a paid API for AI agents from freetier-agent-api.pages.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Scans up to 20 ERC-20 token addresses in one call for risk levels, scores, flags, liquidity, and price on Base or Ethereum, returning a portfolio-level summary.

## Facts

- Endpoint: GET https://freetier-agent-api.pages.dev/api/token-portfolio?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-portfolio-risk-scanner-df24ad37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8FV9qOpy7P1j7EaQscxsU

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 token-portfolio-risk-scanner-df24ad37
```

Example prompt: Can you run a risk scan on these 5 Base tokens for me: 0xAbc..., 0xDef..., 0x123..., 0x456..., 0x789...? I want to know which ones are high risk and why, including honeypot flags and liquidity info.

## When to prefer this

Use this endpoint when you need to assess risk across multiple ERC-20 tokens in a single call rather than checking them one by one. It is ideal for pre-trade due diligence, wallet audits, or portfolio monitoring on Base or Ethereum. It aggregates GoPlus Security contract analysis (honeypot simulation, taxes, holder concentration, LP lock) with DexScreener liquidity and price data, making it more comprehensive than a single-source token scanner. Prefer this over manual chain explorers when you need structured, agent-parseable risk output across a batch of addresses.

## Known failure modes

- More than 20 addresses supplied — API rejects or truncates input
- Invalid or non-ERC-20 contract address causes unknown risk level for that token
- Token not found on DexScreener returns null liquidity/price data
- Unsupported chain (not Base or Ethereum) causes validation error
- GoPlus API rate limit or downtime results in missing contract flag data
- Malformed comma-separated address string causes parsing failure

## How this service works

Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.

## Output

Returns a JSON object with a `tokens` array (each entry containing symbol, risk level, risk score, top flags with source field names, liquidity, and price) and a `summary` object (counts per risk level, average risk score, and list of riskiest tokens). Risk levels are low, medium, high, or unknown.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "addresses"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string",
       "description": "default base"
      },
      "addresses": {
       "type": "string",
       "description": "comma-separated token addresses, max 20"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tokens": [
   {
    "symbol": "DEGEN",
    "riskLevel": "low",
    "riskScore": 16
   }
  ],
  "summary": {
   "low": 3,
   "high": 0,
   "medium": 0,
   "tokens": 3,
   "unknown": 0,
   "averageRiskScore": 9
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-portfolio-risk-scanner-df24ad37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from freetier-agent-api.pages.dev](https://www.zero.xyz/host/freetier-agent-api.pages.dev/llms.txt)