# Frax Finance Pools & Yield API
> Live liquidity-pool and yield data for the Frax Finance ecosystem — the FRAX stablecoin, frxETH and FXS — from the public Frax API, no key, nothing stored. This is the Frax-yield view: every incentivised Frax liquidity pool across every chain and DEX, with its locked liquidity and APY, distinct from the generic DeFi-yield and protocol APIs in the catalogue. The pools endpoint lists Frax pools — optionally filtered by chain or DEX platform — with the trading pair, the pool tokens, the value locked and the base and maximum APY. The pool endpoint returns one pool in full, including the reward breakdown across swap fees and incentive rewards. The summary endpoint aggregates the ecosystem: total value locked, the pool count and the distribution across chains and DEX platforms, plus the highest-yielding pools. Build DeFi yield dashboards, Frax-farming optimisers, APY trackers and treasury tools on top of real Frax Finance data. Filter by chain (ethereum, arbitrum, fraxtal, optimism, polygon and more) or platform (uniswap_v3, curve, convex, balancer); pool APYs are returned as percentages.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/frax-api/..."
```

## Pricing
- **Free** (Free) — 13,500 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 200,000 calls/Mo, 10 req/s
- **Pro** ($25/Mo) — 815,000 calls/Mo, 28 req/s
- **Scale** ($56/Mo) — 2,950,000 calls/Mo, 60 req/s

## Endpoints

### Pools

#### `GET /v1/pools` — Frax pools ranked by liquidity

**Parameters:**
- `chain` (query, optional, string) — Filter by chain (ethereum, fraxtal, arbitrum…) Example: `ethereum`
- `platform` (query, optional, string) — Filter by DEX platform (curve, uniswap_v3…) Example: `curve`
- `limit` (query, optional, string) — Max pools (default 50, max 273) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/frax-api/v1/pools?chain=ethereum&platform=curve&limit=50"
```

### Pool

#### `GET /v1/pool` — One pool in full with reward breakdown

**Parameters:**
- `id` (query, required, string) — Pool identifier Example: `Uniswap V3 FRAX/USDC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/frax-api/v1/pool?id=Uniswap+V3+FRAX%2FUSDC"
```

### Summary

#### `GET /v1/summary` — Ecosystem aggregate — TVL, chain/platform split

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/frax-api/v1/summary"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/frax-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/frax-api
OpenAPI spec: https://www.oanor.com/api/frax-api/openapi.json