# Uniswap Pool Liquidity: Reserves and Price

> Uniswap Pool Liquidity: Reserves and Price is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-12).

Returns all Uniswap v3 pools for a token pair across fee tiers with in-range liquidity, token balances, current price, and tick — sorted deepest first — on Base, Ethereum, Arbitrum, Optimism, or Polygon.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/uniswap/liquidity?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-uniswap-pool-liquidity-33c4cd3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CyLxDINLROOqR7KoTiya1

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 agent-data-tools-revmesh2074-workers-dev-uniswap-pool-liquidity-33c4cd3d
```

Example prompt: What's the current liquidity and price across all Uniswap v3 fee tiers for WETH/USDC on Ethereum — I want to know which pool is deepest before I do a large swap.

## When to prefer this

Use this endpoint when you need live, on-chain Uniswap v3 pool data — specifically liquidity depth, token reserves, and spot price — across all fee tiers for a pair, before routing or sizing a swap. Prefer this over centralized price APIs when you need to verify actual on-chain depth rather than an aggregated index price, or when you need the pool address itself for further on-chain interaction. It covers five major EVM chains, making it the right choice for multi-chain DeFi workflows.

## Known failure modes

- Unrecognized ticker symbol — returns error if tokenA or tokenB ticker cannot be resolved to an address
- No pools found — returns empty pools array if no Uniswap v3 pool exists for the pair on the specified chain
- Unsupported chain — error if a chain name other than ethereum, base, arbitrum, optimism, or polygon is supplied
- RPC timeout — on-chain read may time out during congestion, resulting in a 5xx error
- Token address typo — invalid 0x address returns an error or empty result

## How this service works

Uniswap pool liquidity for a token pair: every Uniswap v3 pool by fee tier with its in-range liquidity, both token balances held, price and current tick, deepest first, read live on Base, Ethereum, Arbitrum, Optimism or Polygon. Use to check a pool's depth before a swap or to price a token from its pool.

## Output

Returns an array of Uniswap v3 pool objects sorted by in-range liquidity descending. Each pool includes its contract address, fee tier (e.g. 500, 3000, 10000), in-range liquidity as a string, token balance for each side, the current price in both directions (priceAinB and priceBinA), and the current tick. Also returns the resolved token symbols and addresses for both inputs, plus the chain queried.

## 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": [
      "tokenA",
      "tokenB"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "examples": [
        "base"
       ],
       "description": "ethereum (default), base, arbitrum, optimism or polygon"
      },
      "tokenA": {
       "type": "string",
       "examples": [
        "WETH"
       ],
       "description": "First token: 0x address or ticker"
      },
      "tokenB": {
       "type": "string",
       "examples": [
        "USDC"
       ],
       "description": "Second token: 0x address or ticker"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string"
      },
      "pools": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "tick": {
          "type": "number"
         },
         "address": {
          "type": "string"
         },
         "feeTier": {
          "type": "number"
         },
         "balanceA": {
          "type": "number"
         },
         "balanceB": {
          "type": "number"
         },
         "liquidity": {
          "type": "string"
         },
         "priceAinB": {
          "type": "number"
         },
         "priceBinA": {
          "type": "number"
         }
        }
       }
      },
      "source": {
       "type": "string"
      },
      "tokenA": {
       "type": "object",
       "properties": {
        "symbol": {
         "type": "string"
        },
        "address": {
         "type": "string"
        }
       }
      },
      "tokenB": {
       "type": "object",
       "properties": {
        "symbol": {
         "type": "string"
        },
        "address": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "Base",
  "pools": [
   {
    "tick": -199500,
    "address": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
    "feeTier": 500,
    "balanceA": 5100.2,
    "balanceB": 9800000.5,
    "liquidity": "1234567890123",
    "priceAinB": 2338.2,
    "priceBinA": 0.000427679
   }
  ],
  "source": "Uniswap v3 factory and pool contracts, read live",
  "tokenA": {
   "symbol": "WETH",
   "address": "0x4200000000000000000000000000000000000006"
  },
  "tokenB": {
   "symbol": "USDC",
   "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-uniswap-pool-liquidity-33c4cd3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)