Developer GuidesGuide

Cetus API on Sui: SDKs, a live pool feed, and a broken link

On 16 November 2026, Cetus carried 57.3% of DexPaprika-indexed Sui DEX volume, with Bluefin second at 39.3%. Its own docs link a pool API that 404s; a working one sits right beside it, current data only.

Cetus API on Sui: SDKs, a live pool feed, and a broken link
Illustration: 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.

None of that is a price history. There are no candles anywhere Cetus publishes, there is no per-swap feed, and the one URL its own docs print for pool data returns HTTP 404. The endpoint that answers lives at a different path.

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. Market data is a smaller part of that story, and the one page that reaches for it links to an address that does not resolve.

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. The version table in the docs trails npm for four of them, so both are shown:

Package Docs npm What it does
sui-clmm-sdk1.4.81.4.9Concentrated liquidity pools, swaps, positions
vaults-sdk1.7.71.7.7Managed vault deposits and withdrawals
farms-sdk1.4.51.4.5Farming and yield operations
xcetus-sdk1.2.41.2.5xCETUS token operations
limit-sdk1.2.61.2.6Limit orders
burn-sdk1.3.21.3.3Token burning
dca-sdk1.2.51.2.5Dollar-cost averaging
zap-sdk1.5.61.5.6One-sided ("zap") liquidity operations
dlmm-sdk1.3.21.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. Called directly instead of through the SDK, its find_routes endpoint is live and answers, it just expects the SDK's request shape:

curl "https://api-sui.cetus.zone/router_v3/find_routes?from=0x2::sui::SUI&target=0x06864a6f921804860930db6ddbe2e16acdf8504495ea7481637a1c8b9a8fe54b::cetus::CETUS&amount=1000000000&by_amount_in=true" {"code":4000,"msg":"version too low"}

That is a trade quote, the same job Uniswap's /quote does: price this specific trade right now. It is not a market-data feed and it was never built to be one.

The pool-data URL in Cetus's own docs 404s

One page goes further than the SDK reference. The Smart Router v2 doc says, verbatim:

"(Speedy) Get pool list from our API. The coin decimals are provided."

"https://api-sui.cetus.zone/v2/sui/pools_info"

Called live on 16 November 2026, that URL returns HTTP 404, as it did when we first checked on 23 September. The link behind that text points at a second domain, api-sui.devcetus.com, for the same path, and that one answered HTTP 503.

What does answer, on the same host as the broken link, is a different path entirely, /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 snapshot, refreshed on request each time you call it. I found no candle or trade-history endpoint on the same host after testing several plausible paths.

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.

The chain as a whole was far quieter than at our first measurement. On 23 September 2026 the same three DEXes carried $42,433,775 in 24 hours; on 16 November, $8,093,363, about a fifth of that. Cetus held its place through the drop, at 58.4% of Sui volume then and 57.3% now. Two single-day readings make no trend; read them as a before and after.

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

Both gaps close the same way, through 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, which no Cetus endpoint I found provides. 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, though that address is not the one printed on the docs page that describes it.

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. I checked several plausible paths for a candle endpoint on the same host and every one of them returned 404.

Can I get Cetus swap history from the API?

Not from anything Cetus documents or runs publicly that I found. 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 answered every call I made, but it is not the URL the docs name for pool data. I found it by testing paths near the one that 404s. Treat it as unstable until Cetus documents it.

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 and the Docs column come from Cetus's developer docs at cetus-1.gitbook.io/cetus-developer-docs, read that day; the npm column is the latest tag of each @cetusprotocol package on the npm registry, also that day. The quoted sentence and URL come from the Smart Router v2 page in the same docs. The URL as printed returned 404 and the domain its link points to returned 503. The endpoint that does work, stats_pools, was found in September by testing paths near the documented one after it failed. On 16 November it 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.

Share this guide
Written by Mateusz Sroka

Original CoinPaprika guide.

Report a correction
All guides

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.