# QuickBuild Base Token Verdict

> QuickBuild Base Token Verdict is a paid API for AI agents from quickbuild.quynguyenbac.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-02).

Scores and grades an ERC-20 token on Base mainnet using on-chain data and market metrics, returning a letter grade, rule-based flags, and key DeFi metrics.

## Facts

- Endpoint: GET https://quickbuild.quynguyenbac.workers.dev/api/base/token-verdict?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quickbuild-base-token-verdict-3a8f99ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tOHt6mdJpMA2-7ZzzSbEW

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 quickbuild-base-token-verdict-3a8f99ed
```

Example prompt: Can you run a verdict on this Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to see the grade, score, flags, and any liquidity or FDV metrics you can pull?

## When to prefer this

Use this endpoint when you need a fast, rule-based, no-LLM token risk assessment for any ERC-20 on Base mainnet, especially when you want structured grades and flags alongside raw DeFi metrics (liquidity, FDV, volume, price change). Prefer this over generic block explorers when you want an opinionated score rather than raw data, and over AI-generated advice when you need deterministic, auditable rules.

## Known failure modes

- 404 if address is not a deployed contract on Base
- 400 if address is malformed or not a valid 0x address
- Null values in metrics for data unavailable from GeckoTerminal or Blockscout
- Network timeouts from upstream RPC or third-party APIs
- Stale or incomplete market data for low-liquidity tokens

## How this service works

Fixed documented point rules (returned in rules[]) over live public Base RPC reads, Blockscout and the free GeckoTerminal API (liquidity, volume, FDV, price change, top pool). Unavailable values are null and not scored (listed in unknown[]). No LLM. Every response has disclaimer: "informational only, not investment advice". Not a contract = 404, invalid = 400, never charged.

## Output

Returns a JSON object with: a letter grade (A–F), an integer score, a rules[] array listing which scoring rules fired, a flags[] array of qualitative risk signals, a metrics object with liquidity, volume, FDV, price change, and top pool data (null for unavailable values), an unknown[] array listing metrics that could not be fetched, a short oneLiner summary, and a disclaimer stating results are informational only and not investment advice. Returns 404 if the address is not a contract, 400 if the address is invalid.

## 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": [],
     "properties": {
      "address": {
       "type": "string",
       "description": "0x ERC-20 token address on Base (default USDC)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "flags": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "grade": {
       "enum": [
        "A",
        "B",
        "C",
        "D",
        "F"
       ],
       "type": "string"
      },
      "rules": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "score": {
       "type": "integer"
      },
      "metrics": {
       "type": "object"
      },
      "unknown": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "oneLiner": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flags": [
   "-5 owner not renounced",
   "-10 upgradeable proxy",
   "+30 well-known major Base token"
  ],
  "grade": "A",
  "score": 100,
  "symbol": "USDC",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chainId": 8453,
  "metrics": {
   "fdvUsd": 4305533689,
   "ageDays": 1076.3,
   "liquidityUsd": 144797093,
   "volume24hUsd": 750954215
  },
  "disclaimer": "informational only, not investment advice"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quickbuild-base-token-verdict-3a8f99ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quickbuild.quynguyenbac.workers.dev](https://www.zero.xyz/host/quickbuild.quynguyenbac.workers.dev/llms.txt)
