# Proofwork Base Token Price API

> Proofwork Base Token Price API is a paid API for AI agents from proofwork-the402-webhook.phase-voice.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the current USD price and metadata for any ERC-20 token on Base Mainnet, with a GeckoTerminal evidence link.

## Facts

- Endpoint: GET https://proofwork-the402-webhook.phase-voice.workers.dev/v1/base-token-price
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proofwork-base-token-price-api-465ccff3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hisatpEGL-kOZKDN6lbus

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 proofwork-base-token-price-api-465ccff3
```

Example prompt: What's the current USD price of WETH on Base Mainnet? The contract address is 0x4200000000000000000000000000000000000006.

## When to prefer this

Choose this endpoint when you need a quick, verifiable USD price for any ERC-20 token on Base Mainnet and want an auditable evidence link to the underlying data source. It is particularly useful for AI agents operating in DeFi or on-chain finance contexts that need lightweight, per-request priced access without a subscription, and where transparent evidence provenance (GeckoTerminal URL) matters.

## Known failure modes

- Invalid or non-Base token address format returns a validation error
- Token address not found on Base Mainnet may return empty or null price data
- GeckoTerminal upstream unavailability causes delayed or failed response
- Malformed 0x address (wrong length or non-hex characters) rejected by schema validation
- Newly deployed tokens with no liquidity may return zero or missing price

## How this service works

Small non-cyber evidence and data APIs payable per request with x402 on Base.

## Output

A JSON object containing the token's name, symbol, contract address, decimals, and current USD price, plus the network identifier ('Base Mainnet') and an array of evidence URLs pointing to the underlying GeckoTerminal data source used to derive the price.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token_address"
     ],
     "properties": {
      "token_address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": {
   "name": "Wrapped Ether",
   "symbol": "WETH",
   "address": "0x4200000000000000000000000000000000000006",
   "decimals": 18,
   "price_usd": 1876.82
  },
  "report": "base_token_price",
  "network": "Base Mainnet",
  "evidence": [
   "https://api.geckoterminal.com/api/v2/networks/base/tokens/0x4200000000000000000000000000000000000006"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/proofwork-base-token-price-api-465ccff3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proofwork-the402-webhook.phase-voice.workers.dev](https://www.zero.xyz/host/proofwork-the402-webhook.phase-voice.workers.dev/llms.txt)