# Tarnak Token Risk Verdict API

> Tarnak Token Risk Verdict API is a paid API for AI agents from api.capousd-student-tools.me, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Returns a risk verdict (safe/caution/danger) for a token contract address on EVM or Solana chains, including rug/honeypot indicators, liquidity, holder distribution, and taxes.

## Facts

- Endpoint: GET https://api.capousd-student-tools.me/v1/token/verdict?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tarnak-token-risk-verdict-api-ebb3092b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pwamQ24Ssjjxa0oM7scyp

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 tarnak-token-risk-verdict-api-ebb3092b
```

Example prompt: Can you check if the token at address 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base is safe — I want to know its risk verdict, any rug or honeypot warnings, and what the buy/sell taxes look like.

## When to prefer this

Choose this endpoint when an AI agent needs a fast, structured risk classification of a token contract before executing a DeFi action — especially when operating keyless on Base or other EVM chains via x402 pay-per-call. Prefer it over manual on-chain inspection when you need a composite verdict aggregating security (GoPlus), liquidity (DexScreener), and holder data in one call. It is particularly suited for autonomous agents that cannot hold API keys and need to pay micro-amounts per query in USDC.

## Known failure modes

- Unknown or very new token contract with no on-chain data returns incomplete record with risk_level 'unknown'
- Invalid or malformed contract address returns 400 error
- Token not found on specified chain returns empty or error response
- Rate limit exceeded beyond 10 free calls per IP per day without payment triggers 402 response
- Unsupported chain value returns validation error
- GoPlus or DexScreener data unavailable causes degraded=true with partial results

## How this service works

Keyless pay-per-call APIs for AI agents on Base: token risk verdict, rug/honeypot report, gas estimate, URL-to-markdown and more. x402 v2, USDC, no API key or signup. 10 free verdicts per IP per day.

## Output

A JSON object containing: a verdict string (safe/caution/danger), risk_level, array of warnings (e.g. 'mintable', 'lp_not_locked'), blockers, buy/sell tax percentages, market data (price, liquidity, FDV, market cap, 24h volume, DEX URL), holder count and top-10 holder percentage, token name/symbol/chain/address, data sources used, and a degraded flag indicating incomplete data.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "optimism",
        "bsc",
        "avalanche",
        "solana"
       ],
       "type": "string",
       "default": "base",
       "description": "Chain the token contract lives on."
      },
      "token": {
       "type": "string",
       "description": "Alias for address."
      },
      "address": {
       "type": "string",
       "maxLength": 44,
       "minLength": 32,
       "description": "Token contract address (EVM 0x... or Solana base58)."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-10-27T00:00:00Z",
  "name": "Degen",
  "chain": "base",
  "notes": [
   "GoPlus record incomplete; risk_level unknown",
   "established market (liquidity >= $1M) but incomplete security record"
  ],
  "taxes": {
   "buy_pct": 0,
   "sell_pct": 0
  },
  "market": {
   "dex": "aerodrome-base",
   "url": "https://dexscreener.com/base/0x...",
   "pair": "0x...pair-address",
   "fdv_usd": 1420000,
   "price_usd": 0.0009237,
   "price_pair": "DEGEN/USDC",
   "liquidity_usd": 262058,
   "market_cap_usd": 1280000,
   "price_inverted": false,
   "volume_24h_usd": 123456
  },
  "symbol": "DEGEN",
  "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
  "holders": {
   "count": 101797,
   "top10_pct": 62.7
  },
  "sources": [
   "goplus",
   "dexscreener"
  ],
  "verdict": "caution",
  "blockers": [],
  "degraded": false,
  "warnings": [
   "mintable",
   "lp_not_locked"
  ],
  "pair_count": 42,
  "risk_level": "unknown"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tarnak-token-risk-verdict-api-ebb3092b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.capousd-student-tools.me](https://www.zero.xyz/host/api.capousd-student-tools.me/llms.txt)