Yield Endpoints

Endpoints for retrieving liquidity pool information and APR data across multiple DEX protocols.

Get Pools Information

Retrieves detailed information about liquidity pools including APR, TVL, volume, and fee data. Endpoint: POST /{chainId}/yield/pools

Path Parameters

chainId (string, required): The blockchain network ID (e.g., 1, 100)

Request Body

Array of pool addresses to query. Pass an empty array [] to fetch all available pools.

Empty array returns all pools (up to result limit)
With addresses returns only specified pools
Maximum: 1000 pool addresses

Response Fields

Field	Type	Description
contract_address	string	Pool contract address
chain_id	number	Blockchain network ID
project	string	Liquidity provider / DEX protocol name
apr	number	Annual Percentage Rate for liquidity providers
fee	number	Pool fee tier as a percentage
tvl	number	Total Value Locked in USD
volume	number	Trading volume in the last 24 hours (USD)

Code Examples

Fetch all pools:

curl -X POST "https://api.cow.fi/1/yield/pools" \
  -H "Content-Type: application/json" \
  -d '[]'

Fetch specific pools:

curl -X POST "https://api.cow.fi/1/yield/pools" \
  -H "Content-Type: application/json" \
  -d '["0x1234567890abcdef1234567890abcdef12345678", "0xabcdef1234567890abcdef1234567890abcdef12"]'

// Fetch all pools
const response = await fetch('https://api.cow.fi/1/yield/pools', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify([])
});
const pools = await response.json();

// Fetch specific pools
const poolAddresses = [
  '0x1234567890abcdef1234567890abcdef12345678',
  '0xabcdef1234567890abcdef1234567890abcdef12'
];
const specific = await fetch('https://api.cow.fi/1/yield/pools', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(poolAddresses)
}).then(r => r.json());

import requests
import json

# Fetch all pools
response = requests.post(
    'https://api.cow.fi/1/yield/pools',
    headers={'Content-Type': 'application/json'},
    data=json.dumps([])
)
pools = response.json()

Response Example

[
  {
    "contract_address": "0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8",
    "chain_id": 1,
    "project": "Uniswap V3",
    "apr": 12.45,
    "fee": 0.3,
    "tvl": 45678901.23,
    "volume": 5678901.45
  },
  {
    "contract_address": "0x06df3b2bbb68adc8b0e302443692037ed9f91b42",
    "chain_id": 1,
    "project": "Balancer",
    "apr": 8.76,
    "fee": 0.25,
    "tvl": 12345678.90,
    "volume": 987654.32
  }
]

Get Average APR by Project

Retrieves the average APR for each liquidity provider/DEX protocol. Endpoint: GET /{chainId}/yield/pools-average-apr

Path Parameters

chainId (string, required): The blockchain network ID (e.g., 1, 100)

Code Examples

curl "https://api.cow.fi/1/yield/pools-average-apr"

const response = await fetch('https://api.cow.fi/1/yield/pools-average-apr');
const averageAprs = await response.json();
console.log(averageAprs);

Response Example

{
  "Uniswap V3": 15.234567,
  "Balancer": 12.456789,
  "Curve": 8.901234,
  "Sushiswap": 10.123456,
  "CoW AMM": 18.567890
}

Notes

Supported DEX Protocols

The API aggregates data from multiple liquidity providers:

Uniswap V2/V3: Concentrated liquidity pools
Balancer: Weighted and stable pools
Curve: Stablecoin and wrapped token pools
Sushiswap: AMM pools
CoW AMM: Native CoW Protocol liquidity
Others: Additional DEX protocols based on availability

APR Calculation

APR represents the yield liquidity providers earn through:

Fee income: Trading fees collected by the pool
Incentives: Token rewards (if applicable)
Time period: Calculated over rolling time windows
Precision: Rounded to 6 decimal places

TVL and Volume

Both metrics are denominated in USD:

TVL: Snapshot of current liquidity
Volume: 24-hour rolling trading volume

Result Limit

The pools endpoint has a maximum result limit of 1000 pools. When fetching all pools (empty array), results are limited to the top pools by TVL.

Caching

Pools Average APR: Cached for 6 hours (21,600 seconds)
Pools Info: Queries are cached at the database level for performance

Fee Tiers

Protocol	Fee Tiers	Description
Uniswap V3	0.01%, 0.05%, 0.3%, 1%	Multiple tier options
Balancer	Variable	Dynamic fees
Curve	0.04% typical	Low fees for stables
Sushiswap	0.3%	Fixed fee

Use Cases

Yield Comparison Dashboard:

const aprs = await fetch('https://api.cow.fi/1/yield/pools-average-apr')
  .then(r => r.json());

Object.entries(aprs).forEach(([protocol, apr]) => {
  console.log(`${protocol}: ${apr.toFixed(2)}%`);
});

Pool Selection for Liquidity:

const pools = await fetch('https://api.cow.fi/1/yield/pools', {
  method: 'POST',
  body: JSON.stringify([])
}).then(r => r.json());

const scoredPools = pools.map(p => ({
  ...p,
  score: p.apr / Math.log(p.tvl)
})).sort((a, b) => b.score - a.score);

console.log('Best pool:', scoredPools[0]);

Best Practices

Cache appropriately: Respect cache headers to reduce load
Batch queries: Request multiple pools in a single call
Handle missing data: Some pools may have incomplete information
Consider impermanent loss: APR doesn’t account for IL
Verify data: Cross-reference with protocol interfaces for critical decisions

BFF

Services

Watch Tower

Yield Endpoints

Yield Endpoints

Get Pools Information

Path Parameters

Request Body

Response Fields

Code Examples

Response Example

Get Average APR by Project

Path Parameters

Code Examples

Response Example

Notes

Supported DEX Protocols

APR Calculation

TVL and Volume

Result Limit

Caching

Fee Tiers

Use Cases

Best Practices

​Yield Endpoints

​Get Pools Information

​Path Parameters

​Request Body

​Response Fields

​Code Examples

​Response Example

​Get Average APR by Project

​Path Parameters

​Code Examples

​Response Example

​Notes

​Supported DEX Protocols

​APR Calculation

​TVL and Volume

​Result Limit

​Caching

​Fee Tiers

​Use Cases

​Best Practices

Yield Endpoints

Get Pools Information

Path Parameters

Request Body

Response Fields

Code Examples

Response Example

Get Average APR by Project

Path Parameters

Code Examples

Response Example

Notes

Supported DEX Protocols

APR Calculation

TVL and Volume

Result Limit

Caching

Fee Tiers

Use Cases

Best Practices