Getting started
Introduction
Cetus Aggregator is a high-speed and easy-to-integrate solution designed to optimize your trading experience on the Sui blockchain. This aggregator integrates multiple mainstream decentralized exchanges (DEX) on the Sui chain, including various types of trading platforms, providing users with the best trading prices and the lowest slippage.
github repo: https://github.com/CetusProtocol/aggregator
For builders and dApps who are using Cetus Aggregator, please upgrade to Aggregator V3 SDK asap to enjoy better experience and maintain your long-term access to the service. V2 and older versions will be deprecated soon.
1. Aggregator V3
Lastest aggregator service uri, package address and npm verison
Lastest aggregator service url
endpoint: https://api-sui.cetus.zone/router_v3/find_routes
When using Aggregator v3 SDK (npm package version ≥ 1.1.1), please remember to switch to this new endpoint.
Latest npm version
@cetusprotocol/aggregator-sdk@1.1.6
Latest package address
AggregatorV3
0x33ec64e9bb369bf045ddc198c81adbf2acab424da37465d95296ee02045d2b17
0x33ec64e9bb369bf045ddc198c81adbf2acab424da37465d95296ee02045d2b17
1
CetusRouter
0xb1e11ceaf3e7cd3031ef5e24804478ec3441c5aecdace910bdaca317a0c1c535
0xb1e11ceaf3e7cd3031ef5e24804478ec3441c5aecdace910bdaca317a0c1c535
1
AfsuiRouter
0xe353802bae757d961af8b1f1bc4c1863f693e757fa4cd6374db4c294fff1bc97
0xe353802bae757d961af8b1f1bc4c1863f693e757fa4cd6374db4c294fff1bc97
1
AftermathRouter
0xb20fbe0c6ccefa73c2e5573cd6fa95436abd03289464a03aa88620a950f19ba1
0xb20fbe0c6ccefa73c2e5573cd6fa95436abd03289464a03aa88620a950f19ba1
1
AlphafiRouter
0x97d7469b1a1f24fa45fe50e9bc144c34bc4e101c84b8b070b6fabcf4c668419d
0x97d7469b1a1f24fa45fe50e9bc144c34bc4e101c84b8b070b6fabcf4c668419d
1
BluefinRouter
0xaa4c2913ee2a4bf001b694817d91dd6218283d9ce94e23b09060642fba5b2600
0xaa4c2913ee2a4bf001b694817d91dd6218283d9ce94e23b09060642fba5b2600
1
BluemoveRouter
0x733561716d0571f11918adfb9e7111d1bfcb11c38636aa6f44fa0b1a170ad03d
0x733561716d0571f11918adfb9e7111d1bfcb11c38636aa6f44fa0b1a170ad03d
1
DeepbookV3Router
0xbb2796b4531ab4e9c72ab95da68fe12ba890a833174b874e9a3e63d8249a835e
0xbb2796b4531ab4e9c72ab95da68fe12ba890a833174b874e9a3e63d8249a835e
1
FlowxRouter
0x5307d1e837ff04985a134b1a7eda2b21b8197bc80781ce000430778d69b111d4
0x5307d1e837ff04985a134b1a7eda2b21b8197bc80781ce000430778d69b111d4
1
HaedalRouter
0xc9337637c28d901b471dde1bae9f4427044c0be72a4bc652daa029e64965088b
0xc9337637c28d901b471dde1bae9f4427044c0be72a4bc652daa029e64965088b
1
KriyaRouter
0x4780f708c7ff01a1048bf22db11b2ab957b8812f8c17e84a7811cac3c33ee451
0x4780f708c7ff01a1048bf22db11b2ab957b8812f8c17e84a7811cac3c33ee451
1
MagmaRouter
0x1ea2ff1d9d477a71bd4de2d3885a10b597f0842d1026e176c58937499b0e3fda
0x1ea2ff1d9d477a71bd4de2d3885a10b597f0842d1026e176c58937499b0e3fda
1
MetastableRouter
0x983e940352c5e84d9544705398e59cdec4c3c1f117594911fc020508b4d789f2
0x983e940352c5e84d9544705398e59cdec4c3c1f117594911fc020508b4d789f2
1
MomentumRouter
0x9ee634c7e78b7b5132ba6ab56f30b51f4feb2b517eb685e5bf5ea1dc959f2fe1
0x9ee634c7e78b7b5132ba6ab56f30b51f4feb2b517eb685e5bf5ea1dc959f2fe1
1
ObricRouter
0xa49729430abfbd1750b22a3dd5d7f303f4e7daea42d3921c111eb592d5fcda0d
0xa49729430abfbd1750b22a3dd5d7f303f4e7daea42d3921c111eb592d5fcda0d
1
ScallopRouter
0x9b7fee5a3eb55fe4b3a14ccabd205af9abe24091ff6fc4d7088c628b9bbfa5d5
0x9b7fee5a3eb55fe4b3a14ccabd205af9abe24091ff6fc4d7088c628b9bbfa5d5
1
SteammRouter
0x87b4289a2d040d37a05fa7839267c2b579d9437c4ba1a4a35c681f80431d9233
0x87b4289a2d040d37a05fa7839267c2b579d9437c4ba1a4a35c681f80431d9233
1
SpringSuiRouter
0x7511f0eea8a0d0f27c9898f5521d0965ca28bf7632972f47acecc9395a78f6a0
0x7511f0eea8a0d0f27c9898f5521d0965ca28bf7632972f47acecc9395a78f6a0
1
TurbosRouter
0x801d5d826e693cbcabe0535f02a91abc6052096e86c9de43f2b05579dc57144b
0x801d5d826e693cbcabe0535f02a91abc6052096e86c9de43f2b05579dc57144b
1
VoloRouter
0xa4cf7a1b2360162bfed6871ae8c25f133f3d09fa939c0518f1bb30d7e4f7e75e
0xa4cf7a1b2360162bfed6871ae8c25f133f3d09fa939c0518f1bb30d7e4f7e75e
1
FullsailRouter
0x9efc9f1df1d3aef0cfe09fed486e9912bbb04c9d7b7ac12594ffefefd8b81313
0x9efc9f1df1d3aef0cfe09fed486e9912bbb04c9d7b7ac12594ffefefd8b81313
1
SevenkRouter
0xc82e012ed846bd22483eba6f8d14c13a98c73212a09e27ac82ed8df5b23ab3a9
0xc82e012ed846bd22483eba6f8d14c13a98c73212a09e27ac82ed8df5b23ab3a9
1
Default Support Providers
v1.1.1
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm&v2, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum,magma,sevenk,fullsail
2. Aggregator V2 (deprecated soon)
Earlier versions (0.x.x) are compatible only with Aggregator v2.
Lastest aggregator service uri, package address and npm verison
Lastest aggregator service url
endpoint: https://api-sui.cetus.zone/router_v2/find_routes
Latest npm version
@cetusprotocol/aggregator-sdk@0.16.0
Latest package address
packageName: "aggregator-v2"
packageId: "0xeffc8ae61f439bb34c9b905ff8f29ec56873dcedf81c7123ff2f1f67c45ec302"
publishedAt: "0x47a7b90756fba96fe649c2aaa10ec60dec6b8cb8545573d621310072721133aa"
version: 12
packageName: "aggregator-extend-v1"
packageId: "0x43811be4677f5a5de7bf2dac740c10abddfaa524aee6b18e910eeadda8a2f6ae"
publishedAt: "0xb39d6dddedd16ed8a40ce0b1e6b43c92acf0ff3fa2fac081fb82ef1b915c17b4"
version: 19
packageName: "aggregator-extend-v2"
packageId: "0x368d13376443a8051b22b42a9125f6a3bc836422bb2d9c4a53984b8d6624c326"
publishedAt: "0x88142be0f2c6b0150980109a7386220b4c040a5c4d9a16d5f7dd0bbd0135ba12"
version: 13
Default Support Providers
v0.3.7
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove
v0.3.10
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, suilen
v0.3.12
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, suilend, bluefin
v0.3.16
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, haedalhmm
v0.3.18
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, springsui, bluefin, haedalhmm, alphafi
v0.3.21
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, haedal, afsui, bluemove, springsui, bluefin, haedalhmm, alphafi
v0.3.28
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, haedal, afsui, bluemove, springsui, bluefin, haedalhmm, alphafi, steamm
v0.3.30
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, haedal, afsui, bluemove, springsui, bluefin, haedalhmm, alphafi, steamm, metastable
v0.3.32
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, haedal, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm, metastable
v0.4.0
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, haedal, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm, metastable,obric
v0.5.0
cetus, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm, metastable,obric,haedal(hasui & hawal)
v0.6.0
cetus, deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm, metastable,obric,haedal(hasui & hawal)
v0.7.0
cetus, deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm), metastable,obric,haedal(hasui & hawal)
v0.8.0
cetus, deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm), metastable,obric,haedal(hasui & hawal), momentum
v0.9.0
cetus, deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm), metastable,obric,haedal(hasui & hawal), momentum
v0.10.0
cetus, deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum
v0.11.0
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum
v0.13.0
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum,magma
v0.14.0
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum,magma,sevenk
v0.15.0
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm&v2, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum,magma,sevenk
v0.16.0
deepbookv3, flowx v2/v3, kriya v2/v3, aftermath, turbos, volo, afsui, bluemove, scallop, springsui, bluefin, haedalhmm&v2, alphafi, steamm(cpmm&omm&ommv2), metastable,obric,haedal(hasui & hawal), momentum,magma,sevenk,fullsail
Last updated