Developer GuidesPrůvodce

Cetus API on Sui: SDKs, live pool data and price history

On 16 November 2026, Cetus carried 57.3% of DexPaprika-indexed Sui DEX volume, Bluefin 39.3%. Cetus ships nine TypeScript SDKs and a keyless pool endpoint; this guide covers both, plus candles for any Cetus pool.

Cetus API on Sui: SDKs, live pool data and price history
Ilustrace: CoinPaprika

The short answer. According to DexPaprika data, Cetus carried 57.3% of indexed Sui DEX volume on 16 November 2026. The Cetus API is SDK-first: nine packages, published Move contract addresses and a trade-routing Aggregator, plus a pool-data endpoint of its own that returns current price, TVL and 24 hour volume for its pools, no key needed.

For price history, candles for any Cetus pool come from DexPaprika with one REST call, shown below, alongside Bluefin and Momentum under the same schema.

Cetus is the largest DEX on Sui by DexPaprika-indexed volume. Its developer docs are built for one job: helping you build against Cetus itself, swaps, concentrated liquidity positions, vaults, farms. This guide covers both halves: what Cetus gives you to build with, and where to read its pool data, live and historical.

Inside the Cetus API: SDKs, contracts, a router

The developer docs live at cetus-1.gitbook.io/cetus-developer-docs, and they are SDK first. SDK V2 ships as nine separate TypeScript packages, each published on npm under @cetusprotocol. Versions are the latest on npm on 16 November 2026:

Package npm What it does
sui-clmm-sdk1.4.9Concentrated liquidity pools, swaps, positions
vaults-sdk1.7.7Managed vault deposits and withdrawals
farms-sdk1.4.5Farming and yield operations
xcetus-sdk1.2.5xCETUS token operations
limit-sdk1.2.6Limit orders
burn-sdk1.3.3Token burning
dca-sdk1.2.5Dollar-cost averaging
zap-sdk1.5.6One-sided ("zap") liquidity operations
dlmm-sdk1.3.3Dynamic liquidity market maker pools

Alongside the SDKs, Cetus publishes its Move contract addresses for every module on mainnet and testnet, and an Aggregator that routes a trade across Sui's DEXes for the best price. Builders call the Aggregator through its own SDK.

That is a trade quote, the same job Uniswap's /quote does: price this specific trade right now.

Where to get Cetus pool data

Beyond the SDKs, Cetus runs a public pool endpoint on its API host, /v2/sui/stats_pools. No key needed:

curl "https://api-sui.cetus.zone/v2/sui/stats_pools" {"code":0,"msg":"success","data":{"total":45355,"lp_list":[...]}}

That call reports 45,355 pools in total (44,336 in September) and returns them a page at a time, 20 rows by default, each with a current price, USD TVL, 24 hour volume, 24 hour fees and APR. I matched the busiest Cetus pool in DexPaprika's data, USDC/SUI, against the same address in stats_pools. The two sources agree on its 24 hour volume to within about 1%: $1,282,608 from Cetus, $1,295,682 from DexPaprika, fetched minutes apart. They quote its price in opposite directions. Cetus gives 1.389, SUI per USDC; DexPaprika gives 0.7205, USDC per SUI, which is SUI's dollar price. What is missing from that object, on every pool: no open, high, low or close, and no row for an individual swap. It is a live snapshot, refreshed each time you call it, which is what a dashboard or a pool picker needs.

Cetus and Bluefin split Sui, Momentum trails

Sui's DEX market is close to a two-way race. DexPaprika indexes three DEXes on the chain, and on 16 November 2026 their 24 hour figures were:

DEX Volume, 24h Pools Transactions, 24h
Cetus$4,636,048647126,557
Bluefin$3,181,46581100,493
Momentum$275,8493514,200
Three DEXes$8,093,363763241,250

Cetus took 57.3% of that volume, Bluefin 39.3%, Momentum 3.4%. Between them, Cetus and Bluefin carried 96.6% of everything DexPaprika indexed on Sui that day. An integration that reads Cetus alone covers most of the chain and misses anything trading mainly on Bluefin.

Cetus has held that lead across our measurements: 58.4% of Sui DEX volume on 23 September 2026, 57.3% on 16 November.

Cetus's own stats_pools count of 45,355 pools is not the same figure as the 647 DexPaprika lists for it. I have not reconciled the two counts, and I would not compare them directly: they very likely count pools under different rules.

Candles and swaps for a Cetus pool

Candles and individual swaps come from an index that already covers Cetus, Bluefin and Momentum under one schema. Sui addresses look different from what EVM chains train you to expect: a token id is a Move type path, not a 20 byte hex string, and it is worth comparing sources rather than trusting one string. CoinPaprika's contract address for CETUS reads 0x6864a6f9...::cetus::CETUS; DexPaprika's token id for the same token reads 0x06864a6f9...::cetus::CETUS, with a leading zero CoinPaprika's copy drops. Match on the module path and the trailing bytes rather than trusting the string to be identical everywhere.

Candles work without a key for the last 24 hours. I ran this on 16 November 2026 against the busiest Cetus pool, USDC/SUI, doing about $1.3 million a day, pool id 0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab:

curl "https://api.dexpaprika.com/networks/sui/pools/0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab/ohlcv?start=-12h&interval=1h&limit=5"

That returns an array of candles, each carrying time_open, time_close, open, high, low, close and volume. The start parameter takes a relative offset such as -12h, so the same call works whenever you run it.

Individual swaps come from the same pool's /transactions endpoint, one row per swap, on Bluefin and Momentum pools as well. That endpoint needs a Dev or Pro plan: called without a key on 16 November it answered HTTP 403, "this endpoint requires a Dev or Pro plan."

A free key from console.dexpaprika.com raises the rate and the quota and reaches further back in candle history. Current numbers for every tier are on the pricing page rather than in this article, because they move. Free-tier data can be up to 60 seconds delayed; real-time is the paid tier.

Common questions

Does Cetus have an API?

Yes, in the sense that matters to a builder: SDKs, a Move contract interface and a trade-routing Aggregator, documented at cetus-1.gitbook.io/cetus-developer-docs. It also runs a keyless pool-data endpoint, api-sui.cetus.zone/v2/sui/stats_pools.

Do you need an API key for Cetus?

No. The SDKs talk to Sui RPC nodes and to Cetus's own endpoints directly, and both the Aggregator and stats_pools answered with no key and no header on 16 November 2026.

Does the Cetus API give historical prices or OHLCV?

No. stats_pools returns a current price, TVL and 24 hour figures per pool and nothing older. For candles on a Cetus pool, use the DexPaprika OHLCV call shown above.

Can I get Cetus swap history from the API?

Cetus's public endpoints return current figures rather than individual swaps. Per-trade data means parsing Sui transactions against Cetus's CLMM contract yourself, or reading it from an index that already does. On DexPaprika that is the pool /transactions endpoint, on a Dev or Pro plan.

Is stats_pools an official Cetus API?

It runs on Cetus's own API host and answered every call I made on 16 November 2026. Read the fields you need by name, so a change to the response shape does not break your code.

Which Sui DEX should I index first?

On the evidence of 16 November 2026, Cetus and Bluefin together carried 96.6% of the chain's DEX volume, Cetus the larger of the two at 57.3%. Momentum was 3.4% that day and worth adding once the first two are covered.

How these numbers were measured

Everything above was read off a live source on 16 November 2026, except the 23 September figures, which come from our first measurement of the same endpoints. Cetus also runs a deployment on Aptos; every figure in this article is Sui only.

The SDK package list comes from Cetus's developer docs at cetus-1.gitbook.io/cetus-developer-docs, read that day; each version is the latest tag of that @cetusprotocol package on the npm registry, also that day. On 16 November the stats_pools endpoint returned HTTP 200 with the USDC/SUI pool present when I searched the response for its address.

The Sui DEX table is one response of GET /networks/sui/dexes, fetched at 10:17 UTC on 16 November 2026, so the rows and the total agree. Shares are of the three DEXes' combined volume in that response, computed by hand rather than read from a network-wide total. The OHLCV call is quoted as it ran and returned HTTP 200; the transactions call returned HTTP 403 without a key.

Every volume figure is a 24 hour window closing on the measurement, so expect it to have moved. The Cetus and Bluefin split is the number most likely to look different in a month.

Full REST reference at docs.dexpaprika.com. There are per-DEX pages with a live swap feed for Cetus and Bluefin on Sui.

The same question for two other DEXes: what the Raydium API covers on Solana, and what the Uniswap API returns. For background on the chain itself, see our Sui blockchain guide.

Sdílet tohoto průvodce
Napsal/a Mateusz Sroka

Původní průvodce CoinPaprika.

Nahlásit opravu
Všechny průvodce

Cryptocurrencies are highly volatile and involve significant risk. You may lose part or all of your investment.

All information on Coinpaprika is provided for informational purposes only and does not constitute financial or investment advice. Always conduct your own research (DYOR) and consult a qualified financial advisor before making investment decisions.

Coinpaprika is not liable for any losses resulting from the use of this information.