# DEX Pool Liquidity Lookup

> DEX Pool Liquidity Lookup is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Fetches real-time liquidity, price, volume, and transaction data for a specific DEX trading pair/pool by chain and pool address

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/dex-pool-liquidity?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dex-pool-liquidity-lookup-c5d7cda4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NMMRePm4qEdvEnC_ETgVi

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 dex-pool-liquidity-lookup-c5d7cda4
```

Example prompt: What's the current liquidity, price, and 24-hour trading volume for the WETH/USDT pool at address 0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36 on Ethereum?

## When to prefer this

Use this endpoint when you need real-time on-chain liquidity, price, and volume data for a specific DEX trading pair identified by its pool address and chain. It is ideal for DeFi analytics, arbitrage evaluation, liquidity monitoring, and trade execution checks. Prefer this over general token price APIs when you need pool-level detail (reserves, tx counts, pair creation date) rather than just a spot price.

## Known failure modes

- Invalid or unsupported chain slug returns an error
- Pool address not found on the specified chain returns empty or error response
- Malformed pool address causes a validation error
- Network or upstream DexScreener API unavailability causes timeout or 5xx error
- Pool exists but has no recent data (very new or inactive pair) may return zeros or partial data

## How this service works

Live DEX pool snapshot from DexScreener for one pool address on one chain (Uniswap, Raydium, Curve and other DEXes DexScreener indexes): USD liquidity, token reserves, price, 24h volume and transactions, FDV. Slippage is not computed. Data is DexScreener's aggregate, not raw on-chain reads.

## Output

Returns a JSON object with the DEX name, chain, pair address, base and quote token symbols, current price in USD and native terms, total liquidity in USD, base and quote reserves, 24-hour volume in USD, 24-hour buy and sell transaction counts, fully diluted valuation in USD, pair creation timestamp, DEX labels (e.g. v3), and the source URL from DexScreener.

## 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": [
      "chain",
      "pool"
     ],
     "properties": {
      "pool": {
       "type": "string",
       "description": "Pool/pair address on that chain"
      },
      "chain": {
       "type": "string",
       "description": "DexScreener chain slug, e.g. ethereum, base, solana, bsc"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dex": "uniswap",
  "chain": "ethereum",
  "fdvUsd": 5346421623,
  "labels": [
   "v3"
  ],
  "source": "https://api.dexscreener.com/latest/dex/pairs/ethereum/0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36",
  "txnsH24": {
   "buys": 333,
   "sells": 230
  },
  "priceUsd": 2399.27,
  "checkedAt": "2026-10-23T09:35:53.764Z",
  "baseSymbol": "WETH",
  "baseReserve": 25570,
  "pairAddress": "0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36",
  "priceNative": 2399.272,
  "quoteSymbol": "USDT",
  "liquidityUsd": 90326871.13,
  "quoteReserve": 28976443,
  "volumeH24Usd": 16657517.49,
  "pairCreatedAt": "2021-05-05T16:37:08.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dex-pool-liquidity-lookup-c5d7cda4/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)