# Uniswap V3 Tick Data

> Uniswap V3 Tick Data is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-24).

Fetches initialized tick data, current price, and liquidity distribution for a Uniswap V3 pool on Ethereum

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/uniswap-v3-ticks?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uniswap-v3-tick-data-b84eb4b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Bu7XGE4_jOBjfKxp57q_

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 uniswap-v3-tick-data-b84eb4b0
```

Example prompt: What does the tick-level liquidity distribution look like for the Uniswap V3 USDC/WETH 0.05% pool right now — show me the current price and initialized ticks within 3 bitmap words on each side?

## When to prefer this

Use this endpoint when you need on-chain, real-time Uniswap V3 tick and liquidity data directly from the Ethereum blockchain without API keys or subscriptions. Prefer it over subgraph queries when you want authoritative on-chain state rather than indexed data, or when you need to analyze liquidity concentration and price impact for a specific pool at the tick level.

## Known failure modes

- Invalid pool address returns an error or empty tick list
- words parameter out of range (must be 1–5) may cause a validation error
- Pool with no initialized ticks in the scanned range returns an empty ticks array
- RPC node unavailability may cause a timeout or upstream error
- Non-Uniswap V3 pool address returns unexpected or empty data

## How this service works

Uniswap V3 liquidity distribution for an Ethereum pool, read on-chain: tokens, fee tier, tick spacing, current tick and price (both directions, decimals applied), in-range liquidity, and every initialized tick within a window around the price with its price, liquidityNet and the active liquidity of the range above it — the shape of concentrated liquidity. Default pool: USDC/WETH 0.05%.

## Output

Returns the pool address, current price in both directions (e.g. USDC per WETH and WETH per USDC), current tick, tick spacing, fee tier percentage, in-range liquidity, token0 and token1 metadata (symbol, address, decimals), a list of initialized ticks each with tick index, liquidityNet, price in both directions, and active liquidity above, plus the scanned tick range and data source URL.

## 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",
     "properties": {
      "pool": {
       "type": "string",
       "description": "Uniswap V3 pool address on Ethereum (default USDC/WETH 0.05%)"
      },
      "words": {
       "type": "string",
       "description": "Tick-bitmap words to scan each side of the price, 1 to 5 (default 2; one word = 256 tick spacings)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pool": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
  "chain": "ethereum",
  "price": {
   "USDC_per_WETH": 2392.786,
   "WETH_per_USDC": 0.00041792288
  },
  "ticks": [
   {
    "tick": 197000,
    "liquidityNet": "93152719939310",
    "price_USDC_per_WETH": 2785.0081,
    "price_WETH_per_USDC": 0.00035906539,
    "activeLiquidityAbove": "1394121808479061853"
   },
   {
    "tick": 197010,
    "liquidityNet": "-5047766297711487",
    "price_USDC_per_WETH": 2782.2246,
    "price_WETH_per_USDC": 0.00035942461,
    "activeLiquidityAbove": "1389074042181350366"
   }
  ],
  "source": "https://ethereum-rpc.publicnode.com",
  "token0": {
   "symbol": "USDC",
   "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
   "decimals": 6
  },
  "token1": {
   "symbol": "WETH",
   "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
   "decimals": 18
  },
  "checkedAt": "2026-10-23T09:36:01.375Z",
  "feeTierPct": 0.05,
  "currentTick": 198518,
  "tickSpacing": 10,
  "scannedTicks": {
   "to": 204799,
   "from": 192000
  },
  "inRangeLiquidity": "2172678991892751475",
  "initializedTicks": 300
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uniswap-v3-tick-data-b84eb4b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)