# Base Token Info Lookup

> Base Token Info Lookup is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Returns name, symbol, decimals, total supply, holder count, price, liquidity, pool count, largest pool, FDV, and 24h volume for any Base chain token contract address.

## Facts

- Endpoint: GET https://aiworker.duckdns.org/v1/token/info
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-token-info-lookup-8ff2a3fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VniOEBGdK2tWZTxsQyOCy

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 base-token-info-lookup-8ff2a3fc
```

Example prompt: Can you look up the token at 0x532f27101965dd16442E59d40670FaF5eBB142E4 on Base and tell me its name, price, total liquidity, 24h volume, and how many holders it has?

## When to prefer this

Choose this endpoint when you need fast, cheap ($0.005/call), deterministic token metadata and market data for a Base chain token — especially price, liquidity, FDV, volume, and holder count — without needing safety analysis. Use the sibling token_check endpoint instead if you also need contract ownership analysis, holder concentration risk, or honeypot simulation.

## Known failure modes

- Invalid contract address format returns validation error
- Token not found on Blockscout returns null token object
- Token has no DEX pools returns null market object
- Blockscout or DexScreener API unavailable returns partial data with source ok:false flags
- Only Base (chain id 8453) is supported; other chains are rejected

## How this service works

The cheapest way to look up a Base token: name, symbol, decimals, total supply, holder count, price, liquidity, pool count, largest pool, FDV and 24h volume, from Blockscout and DexScreener. Deterministic, no LLM, seconds per call. It is the data half of token_check; for contract ownership, holder concentration and a honeypot simulation, buy that instead. Informational only.

## Output

A JSON object with: chain identifier, token metadata (name, symbol, decimals, total_supply, holders_count), market data (price_usd, fdv_usd, liquidity_usd_total, volume_24h_usd, pools count, largest_pool with DEX name/pair address/liquidity), data sources with health status, attribution, disclaimer, and generated_at timestamp.

## 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": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base"
       ],
       "type": "string",
       "description": "chain to look up; only \"base\" is supported in v1"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "a Base (chain id 8453) token contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string"
      },
      "token": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "symbol": {
         "type": "string"
        },
        "decimals": {
         "type": "integer"
        },
        "total_supply": {
         "type": "string"
        },
        "holders_count": {
         "type": "integer"
        }
       }
      },
      "market": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "pools": {
         "type": "integer"
        },
        "fdv_usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "price_usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "largest_pool": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "dex": {
           "type": "string"
          },
          "pair_address": {
           "type": "string"
          },
          "liquidity_usd": {
           "type": "number"
          }
         }
        },
        "volume_24h_usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "liquidity_usd_total": {
         "type": "number"
        }
       }
      },
      "address": {
       "type": "string"
      },
      "sources": {
       "typ
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "eip155:8453",
  "token": {
   "name": "Brett",
   "symbol": "BRETT",
   "decimals": 18,
   "total_supply": "9999997544340006294456944163",
   "holders_count": 948041
  },
  "market": {
   "pools": 8,
   "fdv_usd": 53458106,
   "price_usd": 0.005394,
   "largest_pool": {
    "dex": "uniswap",
    "pair_address": "0xBA3F945812a83471d709BCe9C3CA699A19FB46f7",
    "liquidity_usd": 1207067.33
   },
   "volume_24h_usd": 8578.98,
   "liquidity_usd_total": 2418020.38
  },
  "address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
  "sources": [
   {
    "ok": true,
    "url": "https://base.blockscout.com/api/v2/tokens/0x532f27101965dd16442E59d40670FaF5eBB142E4",
    "name": "blockscout_token"
   }
  ],
  "disclaimer": "Informational only; not investment advice. A data lookup, not a safety check: contract, holder and honeypot analysis is token_check.",
  "attribution": "Data: Blockscout (Base), DexScreener (derived)",
  "generated_at": "2026-09-09T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-token-info-lookup-8ff2a3fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)