# Grokzilla Token Price Oracle

> Grokzilla Token Price Oracle is a paid API for AI agents from grokzilla.shop, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-27).

Returns a cross-validated USD price for a Base ERC-20 token, sourced from DeFiLlama and the deepest on-chain Uniswap/Aerodrome pool, with spread, staleness, and confidence metrics.

## Facts

- Endpoint: POST https://grokzilla.shop/api/skills/token-price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/grokzilla-token-price-oracle-8e395fcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y1JXpKmSMDfpLzonR2DxC

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 grokzilla-token-price-oracle-8e395fcf -d '<json body>'
```

Example prompt: What's the current USD price of the Base ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and how confident is the source agreement?

## When to prefer this

Choose this endpoint when you need a USD price for a Base ERC-20 token that is cross-validated against both DeFiLlama and the deepest on-chain pool (Uniswap/Aerodrome), and you want built-in protection against stale or divergent data. It is especially valuable when price reliability and confidence metrics matter — e.g. before executing a swap, valuing a portfolio, or gating an action on price. It refuses gracefully rather than returning a bad price, making it safer than single-source oracles.

## Known failure modes

- Source disagreement over 2.5%: request refused, no charge applied
- One price source missing or unavailable: request refused, no charge applied
- Invalid contract address format: validation error returned
- Unsupported chain (non-Base): rejected at input validation
- Token not found in either DeFiLlama or on-chain pool: data unavailable error

## How this service works

Verified USD price for a Base ERC-20: DeFiLlama cross-checked against the deepest on-chain Uniswap/Aerodrome pool. Returns price, spread, staleness, confidence. Refused, not charged, if sources disagree over 2.5% or one is missing. Data only, not investment advice.

## Output

Returns a JSON object containing the USD price of the requested Base ERC-20 token, the spread between DeFiLlama and the on-chain pool, a staleness indicator, and a confidence score. If the two sources disagree by more than 2.5% or one source is unavailable, the request is refused and no charge is applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base"
   ],
   "type": "string",
   "default": "base"
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Base ERC-20 contract address"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]+$",
   "maxLength": 64,
   "minLength": 1,
   "description": "Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "agree": true,
   "chain": "base",
   "token": "0x4200000000000000000000000000000000000006",
   "symbol": "WETH",
   "decimals": 18,
   "by_source": {
    "onchain": {
     "pool": {
      "dex": "uniswap_v3",
      "quote": "USDC",
      "address": "0x6c561b446416e1a00e8e93e221854d6ea4171372",
      "variant": "fee 3000",
      "quote_side_usd": 60045166.09
     },
     "block": 52723111,
     "price_usd": "2431.203",
     "weth_usd_onchain": 2431.202812620857
    },
    "defillama": {
     "as_of": "2026-10-17T11:11:51Z",
     "price_usd": "2434.91",
     "confidence": 0.99,
     "staleness_s": 58
    }
   },
   "price_usd": "2433.056",
   "disclaimer": "Data only, not investment advice. Spot prices from public sources at one point in time; they can be stale, manipulated in thin pools, or wrong. No buy/sell signal is given or implied.",
   "spread_pct": 0.1524,
   "sources_agree_within_pct": 2.5
  },
  "next": [
   "token_risk"
  ],
  "skill": "token_price",
  "charged": true,
  "service": "token_price",
  "sources": [
   {
    "url": "https://coins.llama.fi/prices/current/base:0x4200000000000000000000000000000000000006",
    "name": "DeFiLlama coins API",
    "fetched_at": "2026-10-17T11:12:48Z"
   },
   {
    "url": "https://basescan.org/address/0x6c561b446416e1a00e8e93e221854d6ea4171372",
    "name": "Base on-chain pool (public RPC)",
    "block": 52723111,
    "fetched_at": "2026-10-17T11:12:48Z"
   }
  ],
  "summary": "WETH $2433.056 (2 sources, spread 0.15%) - data only, not advice",
  "version": "1.0.0",
  "warnings": [],
  "confidence": 0.975,
  "data_as_of": "2026-10-17T11:11:51Z",
  "disclaimer": "Data only, not investment advice. Spot prices from public sources at one point in time; they can be stale, manipulated in thin pools, or wrong. No buy/sell signal is given or implied.",
  "generated_at": "2026-10-17T11:12:49Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grokzilla-token-price-oracle-8e395fcf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grokzilla.shop](https://www.zero.xyz/host/grokzilla.shop/llms.txt)