# Curve Finance Pools Lookup

> Curve Finance Pools 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 Curve Finance liquidity pool data including coins, balances, USD totals, and pool addresses from Ethereum mainnet

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/finance/curve-finance-pools?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/curve-finance-pools-lookup-0d823453
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gP90pbUd-C6_xbt6gyAKT

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 curve-finance-pools-lookup-0d823453
```

Example prompt: Can you pull the top 20 Curve Finance pools from Ethereum and filter for ones with 'tricrypto' in the name so I can see their coin balances and total USD locked?

## When to prefer this

Use this endpoint when you need real-time Curve Finance pool data from Ethereum without setting up an API key or account. It is ideal for DeFi agents that need to browse or search Curve pools, check pool composition, or get current USD valuations of liquidity positions. Prefer this over building direct blockchain queries when you want structured, pre-parsed pool data with USD prices already calculated.

## Known failure modes

- Invalid limit value outside 1-50 range may return an error or default
- Search string with no matching pools returns an empty pools array
- Upstream Curve Finance API unavailability may cause timeout or error response
- Payment failure results in no charge and no data returned

## How this service works

Curve Finance pools on Ethereum (all but the tiniest, as Curve's 'big' list): pool name, total USD value locked in the pool, and each coin with its USD price and balance, sorted by pool size. Optional name filter.

## Output

Returns a JSON object with an array of pools, each containing the pool name, contract address, asset type (e.g. 'usd'), USD total value, coin list with symbols and USD prices, and raw pool balances. Also includes the source URL from curve.finance, the number of matched pools, and a timestamp of when data 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 50 (default 10)"
      },
      "search": {
       "type": "string",
       "description": "Optional text to match in the pool name, e.g. 3pool, tricrypto"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pools": [
   {
    "name": "Curve.fi Factory USD Metapool: Magic Internet Money 3Pool",
    "coins": [
     {
      "symbol": "MIM",
      "usdPrice": 0.0383347278778544,
      "poolBalance": "3765295779315880109449777"
     },
     {
      "symbol": "3Crv",
      "usdPrice": 1.038979582837548,
      "poolBalance": "5381569962523485722452"
     }
    ],
    "address": "0x5a6A4D54456819380173272A5E8E9B9904BdF41B",
    "usdTotal": 149932.9303943817,
    "assetType": "usd"
   },
   {
    "name": "Curve.fi Factory USD Metapool: Magic Internet Money 3Pool",
    "coins": [
     {
      "symbol": "MIM",
      "usdPrice": 0.0383347278778544,
      "poolBalance": "3765295779315880109449777"
     },
     {
      "symbol": "3Crv",
      "usdPrice": 1.038979582837548,
      "poolBalance": "5381569962523485722452"
     }
    ],
    "address": "0x5a6A4D54456819380173272A5E8E9B9904BdF41B",
    "usdTotal": 149932.9303943817,
    "assetType": "usd"
   }
  ],
  "source": "https://api.curve.finance/v1/getPools/big/ethereum",
  "matched": 2,
  "checkedAt": "2026-10-23T09:36:12.874Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/curve-finance-pools-lookup-0d823453/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)