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, with Bluefin second at 39.3%. Cetus's public pool endpoint gives current prices, TVL and 24 hour figures, but no price history.

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. Cetus publishes no candles and no per-swap feed. Its pool endpoint, stats_pools, gives current figures and nothing older.
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:
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.
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 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:
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 none of them served candles.
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 the developer docs do not describe it yet, so treat its response shape as subject to change.
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 stats_pools endpoint was found in September by testing paths on the Cetus API host. 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.
CoinPaprikaオリジナルガイド。