# Base Onchain Uniswap Pool Intelligence Endpoint

> Base Onchain Uniswap Pool Intelligence Endpoint is a paid API for AI agents from x402-data-api.bodhinindustries.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches live Uniswap V3 pool data for any Base ERC-20 token against WETH, including spot price, liquidity depth, fee tier breakdown, and liquidity risk flags — computed directly from Base chain state.

## Facts

- Endpoint: GET https://x402-data-api.bodhinindustries.workers.dev/pool
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-onchain-uniswap-pool-intelligence-endpoint-26d00364
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yRJ6fPzYu0SaSUqisLznt

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-onchain-uniswap-pool-intelligence-endpoint-26d00364
```

Example prompt: Can you check the Uniswap V3 pool liquidity and spot WETH price for the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know if the liquidity is fragmented across fee tiers and which pool is deepest?

## When to prefer this

Prefer this endpoint when you need trustless, on-chain-verified Uniswap V3 pool data for Base ERC-20 tokens with no reliance on third-party price feeds or aggregators. Ideal for DeFi safety checks, liquidity audits, and manipulation-resistant price discovery on the Base network specifically. Choose over CoinGecko/CoinMarketCap when you need raw on-chain truth rather than aggregated market data.

## Known failure modes

- Token address not found on Base — returns empty pools array with poolsFound: 0
- Token has no Uniswap V3 WETH pools at any fee tier — flags may include low_total_liquidity
- Malformed or non-ERC-20 address input — likely returns error or empty result
- Base RPC unavailability causing computation failure
- Payment validation failure via x402 protocol — 402 response before data is returned

## How this service works

Self-computed Base onchain toolkit for AI agents: ERC-20 safety scan, manipulation-resistant TWAP price oracle, gas/fee oracle, calldata decoder, token/address/contract intel, wallet approval-risk audit, and batch token triage — all computed live from raw Base chain, no third-party data.

## Output

Returns the current Base block height, the token symbol, all Uniswap V3 fee-tier pools found (with existence flag, fee tier, pool address, WETH liquidity depth, and spot price), the deepest fee tier, total WETH liquidity summed across tiers, liquidity concentration percentage, and risk flags like 'single_tier_only', 'fragmented_liquidity', or 'low_total_liquidity'. All data is computed live from Base chain with no third-party data sources.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token"
 ],
 "properties": {
  "token": {
   "type": "string",
   "description": "Base ERC-20 to map against WETH."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "block": {
   "type": "integer",
   "description": "Base block height"
  },
  "flags": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "e.g. single_tier_only, fragmented_liquidity, low_total_liquidity"
  },
  "pools": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "exists": {
      "type": "boolean",
      "description": "pool exists"
     },
     "feeTier": {
      "type": "integer",
      "description": "fee tier"
     },
     "poolAddress": {
      "type": "string",
      "description": "pool address (or null)"
     },
     "liquidityWeth": {
      "type": "number",
      "description": "WETH depth"
     },
     "spotPriceWeth": {
      "type": "string",
      "description": "WETH per token (or null)"
     }
    }
   }
  },
  "token": {
   "type": "string",
   "description": "token mapped"
  },
  "symbol": {
   "type": "string",
   "description": "token symbol"
  },
  "computedAt": {
   "type": "string",
   "description": "ISO-8601 timestamp"
  },
  "poolsFound": {
   "type": "integer",
   "description": "count of existing token/WETH pools"
  },
  "quoteAsset": {
   "type": "string",
   "description": "WETH"
  },
  "deepestFeeTier": {
   "type": "integer",
   "description": "fee tier of the deepest pool"
  },
  "thirdPartyDataUsed": {
   "type": "boolean",
   "description": "always false"
  },
  "totalLiquidityWeth": {
   "type": "number",
   "description": "summed WETH depth across tiers"
  },
  "liquidityConcentrationPct": {
   "type": "number",
   "description": "deepest pool's share of total depth"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-onchain-uniswap-pool-intelligence-endpoint-26d00364/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.bodhinindustries.workers.dev](https://www.zero.xyz/host/x402-data-api.bodhinindustries.workers.dev/llms.txt)