# Balancer V2 Liquidity Pools Data

> Balancer V2 Liquidity Pools Data 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-25).

Returns a list of Balancer V2 liquidity pools with their tokens, types, 24h volume, and total liquidity in USD

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/balancer-v2-pools?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/balancer-v2-liquidity-pools-data-da590e25
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WDguOm9u45MjINlL8xMHq

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 balancer-v2-liquidity-pools-data-da590e25
```

Example prompt: Can you pull a list of the top 10 Balancer V2 liquidity pools, including their token pairs, pool types, 24-hour trading volume, and total liquidity in USD?

## When to prefer this

Choose this endpoint when you need structured, ready-to-use Balancer V2 pool data without setting up a direct GraphQL query to the Balancer API, especially in agent workflows where pay-per-call with no API key is preferable. It is ideal for DeFi research, liquidity monitoring, or pool discovery tasks that need a quick snapshot of top pools including token composition and liquidity metrics.

## Known failure modes

- Invalid limit parameter (outside 1-20 range) may return an error or default behavior
- Upstream Balancer API unavailability could result in stale or missing data
- Network timeout from the worker proxy layer
- Payment failure via x402 protocol will not be charged but the call won't complete

## How this service works

Balancer V2 pools by total liquidity (USD): pool name, type (weighted, stable, composable stable, and others), token symbols with weights where the pool has them, 24h volume and address. Top 1 to 20. Values are as the Balancer API reports them; some pools show implausible liquidity and are not corrected.

## Output

Returns a JSON object with a count field, a list of pool objects each containing pool ID, name, type (e.g. STABLE, GYROE), protocol version, address, array of tokens with symbol and address, 24h volume in USD, and total liquidity in USD, plus the data source URL and timestamp of when it was checked.

## 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": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "How many pools, 1 to 20 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "pools": [
   {
    "id": "0x4e415957aa4fd703ad701e43ee5335d1d7891d8300020000000000000000053b",
    "name": "Another DEI, another dollar",
    "type": "STABLE",
    "tokens": [
     {
      "symbol": "multiUSDC",
      "weight": null,
      "address": "0x04068da6c83afcfa0e13ba15a6696662335d5b75"
     },
     {
      "symbol": "DEI",
      "weight": null,
      "address": "0xde1e704dae0b4051e80dabb26ab6ad6c12262da0"
     }
    ],
    "address": "0x4e415957aa4fd703ad701e43ee5335d1d7891d83",
    "volume24hUsd": 0,
    "protocolVersion": 2,
    "totalLiquidityUsd": 337677697052.7
   },
   {
    "id": "0xc8398feef7aa2a8638473ca6569af217448d080a0002000000000000000006f5",
    "name": "Gyroscope ECLP GYD/sUSDS",
    "type": "GYROE",
    "tokens": [
     {
      "symbol": "sUSDS",
      "weight": null,
      "address": "0xa3931d71877c0e7a3148cb7eb4463524fec27fbd"
     },
     {
      "symbol": "GYD",
      "weight": null,
      "address": "0xe07f9d810a48ab5c3c914ba3ca53af14e4491e8a"
     }
    ],
    "address": "0xc8398feef7aa2a8638473ca6569af217448d080a",
    "volume24hUsd": 0,
    "protocolVersion": 2,
    "totalLiquidityUsd": 17219389.43
   }
  ],
  "source": "https://api-v3.balancer.fi/",
  "checkedAt": "2026-10-23T09:36:03.215Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/balancer-v2-liquidity-pools-data-da590e25/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)