# Blackwood State Base Token Price

> Blackwood State Base Token Price is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Returns the real-time USD price of any Base-chain token computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, along with pool address, fee tier, and liquidity depth.

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackwood-state-base-token-price-45fae1be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lrb24ZW938eLiStMVv41J

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 blackwood-state-base-token-price-45fae1be -d '<json body>'
```

Example prompt: What's the current on-chain USD price of cbBTC on Base? Pull it from the deepest Uniswap v3 pool and also tell me the pool address and liquidity depth.

## When to prefer this

Use this endpoint when you need a real-time, on-chain USD price for a token that trades on Base via Uniswap v3. It is ideal for DeFi portfolio valuation, trade execution checks, or token discovery. Prefer it over off-chain price APIs when trustless, on-chain accuracy matters. Do not use it for tokens that only trade on Aerodrome or other Base DEXs, for tokens on other chains, or for historical prices and OHLC data.

## Known failure modes

- Token not found on Base or has no Uniswap v3 pool — returns null price or error
- Token only trades on other DEXs (e.g. Aerodrome) — not supported, no price returned
- Invalid contract address format — returns validation error
- Token exists but has insufficient liquidity for a meaningful price — may return low depth or null
- Network latency from on-chain RPC calls may exceed p95 of 1200ms under load

## How this service works

Use when you need a crypto token price or market data for a Base token, quoted from on-chain liquidity. Do not use for tokens that only trade off Base or on other DEXs (Aerodrome is not read), price history or OHLC. Returns JSON with the USD price of a token on Base computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, with pool, fee tier and depth for 0.003 USDC per call. Typical response time 1200 ms (p95). Category: Trading.

## Output

A JSON object containing the token's USD price computed from its deepest Uniswap v3 pool on Base, along with the pool contract address, fee tier (e.g. 500, 3000), liquidity depth in USD, the quote currency used (USDC or WETH), token symbol, decimals, block number, and data source. Also includes a suggested next call hint.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "maxLength": 42,
       "minLength": 2,
       "description": "Token on Base: contract address (0x...) or a symbol like WETH, cbBTC, AERO, DEGEN, VIRTUAL"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "token",
      "symbol",
      "decimals",
      "priceUsd",
      "quote",
      "pool",
      "feeTier",
      "depthUsd",
      "blockNumber",
      "source"
     ],
     "properties": {
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
       "additionalProperties": false
      },
      "pool": {
       "type": [
        "string",
        "null"
       ]
      },
      "quote": {
       "enum": [
        "USDC",
        "WET
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pool": "0x6c561B446416E1A00E8E93E221854d6eA4171372",
  "quote": "USDC",
  "token": "0x4200000000000000000000000000000000000006",
  "source": "Uniswap v3 on Base (on-chain)",
  "symbol": "WETH",
  "feeTier": 3000,
  "decimals": 18,
  "depthUsd": 56610101,
  "priceUsd": 2421.2474,
  "blockNumber": 52713897
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackwood-state-base-token-price-45fae1be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)