# Cetus API
> Live data from Cetus, the largest concentrated-liquidity (CLMM) DEX on Sui, which runs most of Sui's on-chain swap volume across thousands of pools. The pools endpoint returns the top pools by TVL, volume or APR — each with its token pair, fee tier, total liquidity, 24h volume and fees, the fee APR and reward APR, and the current price. The pool endpoint returns one pool's full state by address. The search endpoint finds pools by token symbol. Read live from Cetus, nothing stored. This is Cetus's own Sui CLMM pool, TVL/volume/APR and pricing layer — distinct from Ethereum and Solana DEX feeds, lending, staking and oracle APIs, and the only Sui-native DeFi feed here.

## 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/cetus-api/..."
```

## Pricing
- **Free** (Free) — 2,100 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 55,000 calls/Mo, 15 req/s
- **Pro** ($27/Mo) — 310,000 calls/Mo, 40 req/s
- **Scale** ($61/Mo) — 1,950,000 calls/Mo, 120 req/s

## Endpoints

### Pools

#### `GET /v1/pools` — Top Sui pools by TVL, volume or APR

**Parameters:**
- `sort` (query, optional, string) — tvl (default), volume or apr Example: `tvl`
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cetus-api/v1/pools?sort=tvl&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "tvl",
        "chain": "sui",
        "count": 25,
        "pools": [
            {
                "name": "USDC-Sui",
                "pair": "USDC-SUI",
                "price": 1.36845767,
                "address": "0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105",
                "token_a": "USDC",
                "token_b": "SUI",
                "tvl_usd": 3928625.14,
                "fee_24h_usd": 8017.62,
                "fee_apr_pct": 74.49,
                "fee_tier_pct": 0.25,
                "total_apr_pct": 89.5676,
                "reward_apr_pct": 15.0777,
                "volume_24h_usd": 3207047.71
            },
            {
                "name": "haSUI-Sui",
                "pair": "haSUI-SUI",
                "price": 1.01724617,
                "address": "0x871d8a227114f375170f149f7e9d45be822dd003eba225e83c05ac80828596bc",
                "token_a": "haSUI",
                "token_b": "SUI",
                "tvl_usd": 2945462.83,
                "fee_24h_usd": 3.19,
                "fee_apr_pct": 0.0395,
                "fee_tier_pct": 0.01,
                "total_apr_pct": 0.0395,
                "reward_apr_pct": 0,
                "volume_24h_usd": 31893.76
            },
            {
                "name": "USDC-Ondo US Dollar Yield",
                "pair": "USDC-USDY",
                "price": 1.37476676,
                "address": "0xdcd762ad374686fa890fc4f3b9bbfe2a244e713d7bffbfbd1b9221cb
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — One pool's full state by address

**Parameters:**
- `address` (query, required, string) — Cetus pool address Example: `0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cetus-api/v1/pool?address=0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105"
```

**Response:**
```json
{
    "data": {
        "name": "USDC-Sui",
        "pair": "USDC-SUI",
        "chain": "sui",
        "price": 1.36845767,
        "source": "Cetus",
        "address": "0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105",
        "token_a": "USDC",
        "token_b": "SUI",
        "tvl_usd": 3928625.14,
        "fee_24h_usd": 8017.62,
        "fee_apr_pct": 74.49,
        "fee_tier_pct": 0.25,
        "total_apr_pct": 89.5676,
        "reward_apr_pct": 15.0777,
        "volume_24h_usd": 3207047.71
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:00.044Z",
        "request_id": "06fa7f2e-1ac7-47f2-9301-8e73a3ddb419"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Find pools by token symbol

**Parameters:**
- `q` (query, required, string) — Token symbol (min 2 chars) Example: `SUI`
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cetus-api/v1/search?q=SUI&limit=25"
```

**Response:**
```json
{
    "data": {
        "chain": "sui",
        "count": 25,
        "pools": [
            {
                "name": "USDC-Sui",
                "pair": "USDC-SUI",
                "price": 1.36845767,
                "address": "0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105",
                "token_a": "USDC",
                "token_b": "SUI",
                "tvl_usd": 3928625.14,
                "fee_24h_usd": 8017.62,
                "fee_apr_pct": 74.49,
                "fee_tier_pct": 0.25,
                "total_apr_pct": 89.5676,
                "reward_apr_pct": 15.0777,
                "volume_24h_usd": 3207047.71
            },
            {
                "name": "haSUI-Sui",
                "pair": "haSUI-SUI",
                "price": 1.01724617,
                "address": "0x871d8a227114f375170f149f7e9d45be822dd003eba225e83c05ac80828596bc",
                "token_a": "haSUI",
                "token_b": "SUI",
                "tvl_usd": 2945462.83,
                "fee_24h_usd": 3.19,
                "fee_apr_pct": 0.0395,
                "fee_tier_pct": 0.01,
                "total_apr_pct": 0.0395,
                "reward_apr_pct": 0,
                "volume_24h_usd": 31893.76
            },
            {
                "name": "USDC-Sui Dollar",
                "pair": "USDC-USDSUI",
                "price": 66.51251557,
                "address": "0xa7417fb5f59e23b0a7826d78f025653823c49265be07bbf6dd9e553ba4249a56",
                "to
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "Cetus API (api-sui.cetus.zone, live)",
        "service": "cetus-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One pool's full state by address (address=0x…).",
            "GET /v1/pools": "Top pools by TVL, volume or APR (sort=tvl, limit=25).",
            "GET /v1/search": "Find pools by token symbol (q=SUI, limit=25)."
        },
        "description": "Live data from Cetus, the largest concentrated-liquidity (CLMM) DEX on Sui, which runs most of Sui's on-chain swap volume across thousands of pools. The pools endpoint returns the top pools by TVL, volume or APR — token pair, fee tier, total liquidity, 24h volume and fees, fee APR and reward APR, and the current price; the pool endpoint returns one pool's full state by address; the search endpoint finds pools by token symbol. Live, no key, nothing stored. Distinct from Ethereum and Solana DEX feeds, lending, staking and oracle APIs — this is Cetus's own Sui CLMM pool, TVL/volume/APR and pricing layer, and the only Sui-native DeFi feed here.",
        "total_pools": 43221,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:00.975Z",
        "request_id": "d50416e6-8aea-42e3-9f76-62731e99dd9c"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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