Menambahkan fitur swap ke produk EVM jarang sekali hanya soal mendapatkan kuotasi harga dari token A ke token B.
Begitu aplikasi berkembang melampaui prototipe sederhana, pengembang juga perlu memikirkan cara menemukan rute, cara menyiapkan transaksi, apa yang terjadi saat trafik meningkat, jaringan mana saja yang dapat didukung, dan biaya apa yang pada akhirnya dibebankan kepada pengguna.
API agregator DEX dapat mengurangi sebagian beban infrastruktur dengan menghubungkan aplikasi ke berbagai sumber likuiditas melalui satu integrasi. Namun, sebelum memilihnya, pengembang biasanya perlu mendapat jawaban yang jelas atas tiga pertanyaan:
Seberapa sulit proses integrasinya? Berapa biayanya? Jaringan apa saja yang didukung?
Panduan ini membahas KyberSwap Aggregator API melalui tiga pertanyaan tersebut, lalu mengulas beberapa faktor tambahan yang perlu dipertimbangkan sebelum menggunakannya di lingkungan produksi.
Bagaimana Cara Kerja Integrasi KyberSwap Aggregator API?
Bagi developer, kekhawatiran pertama biasanya bukanlah jumlah fitur yang dimiliki API. Yang lebih penting adalah seberapa banyak pekerjaan teknis yang diperlukan sejak permintaan pertama hingga swap berfungsi di dalam produk.
KyberSwap Aggregator API dirancang untuk menangani penemuan likuiditas dan perutean, sementara aplikasi tetap mengendalikan antarmuka dan alur eksekusinya sendiri.
Alih-alih mengintegrasikan DEX satu per satu dan membangun logika perutean terpisah untuk setiap platform, aplikasi dapat mengirim permintaan perdagangan ke KyberSwap. Aggregator mencari likuiditas yang tersedia dan mengembalikan rute yang kemudian dapat digunakan untuk menyusun transaksi swap.
Seperti Apa Alur Integrasi Dasarnya?
KyberSwap memisahkan penemuan rute dari pembuatan transaksi.
Saat pengguna memilih pasangan token dan jumlah transaksi, aplikasi terlebih dahulu meminta rute. Responsnya mencakup informasi seperti perkiraan jumlah keluaran, detail rute, estimasi gas, dan kontrak router yang akan digunakan untuk eksekusi.
Setelah pengguna siap melakukan perdagangan, aplikasi mengirimkan rute terpilih kembali melalui endpoint build, beserta parameter khusus transaksi seperti pengirim, penerima, toleransi slippage, dan tenggat waktu.
KyberSwap kemudian mengembalikan data transaksi yang telah dienkode dan diperlukan untuk eksekusi.
Bagi developer, alurnya sederhana:
temukan rute → buat transaksi → biarkan pengguna mengeksekusinya secara on-chain
Memisahkan tahapan ini memberi aplikasi kendali lebih besar atas kapan perutean dilakukan dan kapan transaksi akhir disiapkan. Ini penting karena rute yang ditampilkan kepada pengguna dapat menjadi usang saat mereka meninjau perdagangan atau mengubah jumlahnya.
Hasilnya adalah model integrasi yang relatif sederhana tanpa mengharuskan aplikasi melepaskan kendali atas pengalaman perdagangannya sendiri.
Apa yang Dibutuhkan Developer untuk Mengakses API?
Penyiapan akses itu penting karena menentukan seberapa cepat tim dapat mulai menguji dan seberapa mudah integrasi dapat ditingkatkan skalanya nanti.
Dokumentasi KyberSwap terbaru mengarahkan integrator ke Swap API gateway di:
https://api.kyberswap.com/swap/
Setiap permintaan ke gateway ini harus menyertakan header X-Api-Key. Developer perlu mendapatkan kunci API tersebut dari tim KyberSwap / BD.
URL dasar yang lama masih berfungsi, tetapi memiliki batas laju, dan dokumentasi menyarankan migrasi ke jalur gateway. Jadi, untuk integrasi baru, gateway sebaiknya dianggap sebagai jalur utama, bukan peningkatan opsional.
Dengan begitu, developer memiliki jalur produksi yang lebih jelas sejak awal.
Apa yang Terjadi Saat Volume Permintaan Meningkat?
Aplikasi perdagangan produksi mungkin menghasilkan jauh lebih banyak permintaan kuotasi daripada jumlah swap yang selesai.
Pengguna mengubah jumlah token, membandingkan pasangan, memperbarui kuotasi, atau keluar sebelum mengirim transaksi. Karena itu, sebuah wallet atau terminal perdagangan dapat menghasilkan lalu lintas API yang cukup besar, meskipun jumlah perdagangan yang akhirnya dieksekusi jauh lebih sedikit.
Itulah sebabnya developer sebaiknya memperkirakan jumlah permintaan kuotasi, bukan hanya volume swap yang diharapkan.
Dengan KyberSwap, pertanyaan praktisnya bukan sekadar apakah API dapat mengembalikan rute yang berfungsi untuk satu transaksi uji. Pertanyaannya adalah apakah pola lalu lintas aplikasi sesuai dengan penggunaan gateway yang diperkirakan saat produk sudah aktif.
Karena dokumentasi terbaru menetapkan Swap API gateway sebagai jalur integrasi utama, tim yang memperkirakan lalu lintas produksi dalam jumlah berarti sebaiknya merencanakan akses gateway bersama KyberSwap sejak awal. Mengandalkan URL dasar lama yang memiliki batas laju lebih cocok untuk penggunaan lama daripada penyiapan produksi baru.
Sebaiknya Gunakan Aggregator API atau KyberSwap Widget?
Tidak semua tim perlu mengendalikan langsung permintaan rute dan pembuatan transaksi.
Jika tujuannya adalah menambahkan antarmuka swap yang berfungsi dengan cepat, KyberSwap Widget menawarkan cara yang lebih cepat dengan lebih sedikit pekerjaan frontend.
Jika produk sudah memiliki antarmuka perdagangan sendiri atau membutuhkan kendali atas pemilihan token, permintaan perutean, pembuatan transaksi, logika biaya, atau alur pengguna secara keseluruhan, Aggregator API adalah pilihan yang lebih fleksibel.
Keputusan bergantung pada seberapa besar kendali yang ingin dimiliki produk atas pengalaman swap.
Berapa Biaya KyberSwap Aggregator API?
Sebuah API mungkin tampak murah selama pengembangan, tetapi biayanya dapat meningkat setelah pengguna mulai melakukan perdagangan dalam skala besar.
Bagi developer, penting untuk membedakan biaya akses API dari biaya eksekusi swap.
KyberSwap Public APIs tidak memerlukan langganan berbayar di muka untuk akses publik biasa. KyberSwap juga memiliki biaya swap 0%.
Namun, bukan berarti semua bagian transaksi gratis.
Gas jaringan berasal dari blockchain itu sendiri. Biaya penyedia likuiditas dapat berasal dari pool yang disertakan dalam rute terpilih.
Biaya-biaya ini terpisah dari biaya Swap KyberSwap sendiri.
Bisakah Developer Menambahkan Biaya Integrator Sendiri?
Sebagian produk menjadikan swap semata-mata sebagai fitur untuk pengguna. Produk lainnya ingin aktivitas perdagangan menjadi bagian dari model bisnis.
KyberSwap Aggregator API memungkinkan aplikasi yang mengintegrasikannya untuk mengatur biaya integrator.
Developer dapat menentukan jumlah biaya, alamat penerima, dan cara pemungutan biaya sebagai bagian dari alur swap. Jika aplikasi tidak mengatur biaya integrator, biaya tersebut tidak akan dikenakan.
Hal ini memberi wallet, aplikasi perdagangan, dan produk Web3 lainnya cara untuk memonetisasi aktivitas swap sambil tetap menggunakan KyberSwap untuk perutean dan pembuatan transaksi.
Biaya integrator terpisah dari biaya swap 0%.
Chain EVM Mana Saja yang Dapat Didukung dengan KyberSwap Aggregator API?
Aplikasi yang diluncurkan di satu jaringan hari ini mungkin membutuhkan beberapa jaringan lain di kemudian hari.
Sebuah proyek mungkin memulai di Base, lalu berkembang ke Ethereum dan Robinhood Chain. Berikutnya, sebuah wallet mungkin membutuhkan Arbitrum atau Optimism. Jika setiap ekspansi mengharuskan arsitektur swap yang sepenuhnya baru, beban pemeliharaan akan meningkat seiring pertumbuhan produk.
KyberSwap Aggregator dirancang agar dapat digunakan di jaringan EVM yang didukung dengan model integrasi umum yang sama.
Developer menentukan jaringan tujuan dalam permintaan API, sementara Aggregator mencari likuiditas yang tersedia di chain tersebut.
KyberSwap saat ini mendukung ekosistem EVM utama, termasuk Ethereum, Base, BNB Chain, Arbitrum, Optimism, Robinhood Chain, serta jaringan lain yang didukung.
Manfaatnya bukan sekadar jumlah jaringan yang tersedia.
Manfaat yang lebih besar adalah aplikasi dapat menggunakan kembali alur umum untuk menemukan rute dan membuat transaksi saat berekspansi ke chain lain yang didukung.
Bisakah Satu Integrasi Digunakan Kembali di Beberapa Chain EVM?
Ya, selama jaringan tersebut didukung oleh KyberSwap.
Misalnya, sebuah dApp diluncurkan di Base lalu menambahkan Ethereum. Aplikasi tidak perlu mengganti seluruh lapisan agregasi. Aplikasi dapat terus menggunakan arsitektur API umum yang sama, sambil mengubah jaringan dan menyesuaikan token serta likuiditas yang tersedia di sana.
Ini mengurangi jumlah infrastruktur perutean yang perlu dibangun ulang oleh tim setiap kali produk berkembang.
Developer tetap sebaiknya memeriksa daftar jaringan yang didukung terbaru sebelum peluncuran karena cakupan chain dapat berubah seiring penambahan ekosistem baru.
Apa Lagi yang Perlu Dievaluasi oleh Developer EVM?
Integrasi, biaya, dan dukungan chain menentukan apakah sebuah API cocok dengan arsitektur produk.
Kualitas perutean menentukan apakah integrasi tersebut benar-benar menghadirkan pengalaman swap yang baik bagi pengguna.
API gratis tidak terlalu bermanfaat jika pengguna terus-menerus mendapatkan eksekusi yang kurang optimal.
Likuiditas di DeFi tersebar di berbagai DEX, pool, dan sumber lainnya. Rute terbaik untuk satu ukuran transaksi belum tentu menjadi rute terbaik untuk ukuran lainnya.
KyberSwap Aggregator mencari di berbagai sumber likuiditas yang tersedia, alih-alih mengharuskan aplikasi memilih satu tempat terlebih dahulu. Aggregator juga dapat membagi transaksi ke beberapa sumber ketika rute gabungan memberikan hasil yang lebih baik.
Bagi pengguna, ini berarti mereka tidak perlu membandingkan beberapa DEX secara manual sebelum berdagang.
Bagi developer, langkah pentingnya adalah menguji API menggunakan pasangan token, jaringan, dan ukuran transaksi yang benar-benar diharapkan dalam produk. Banyaknya sumber likuiditas merupakan informasi yang berguna, tetapi pengujian rute nyata memberikan dasar yang lebih kuat untuk mengambil keputusan.
Apakah KyberSwap Aggregator API Cocok untuk Aplikasi EVM Anda?
KyberSwap Aggregator API paling relevan ketika kebutuhannya lebih dari sekadar menambahkan satu fitur swap sederhana.
Developer mungkin perlu menghindari pemeliharaan beberapa integrasi DEX, meluncurkan produk tanpa membayar langganan API di muka, berekspansi ke berbagai jaringan EVM, mengakses likuiditas yang terfragmentasi, atau membangun model pendapatan berdasarkan volume swap.
KyberSwap memenuhi kebutuhan tersebut melalui satu arsitektur Aggregator, alur integrasi route dan build, akses API publik, biaya swap 0%, biaya integrator yang dapat dikonfigurasi, serta dukungan untuk berbagai jaringan EVM.
Keputusan akhir tetap perlu diuji berdasarkan kebutuhan nyata aplikasi.
Pertimbangkan jaringan yang dibutuhkan produk, pasangan yang kemungkinan diperdagangkan pengguna, perkiraan jumlah permintaan kuotasi, ukuran transaksi yang umum, serta tingkat kendali yang dibutuhkan aplikasi atas pengalaman swap.
Pertanyaan yang tepat bukan sekadar apakah KyberSwap Aggregator API memiliki fitur yang cukup. Pertanyaannya adalah apakah API ini dapat mengurangi cukup banyak pekerjaan perutean dan integrasi produk, sekaligus tetap memberi developer kendali, model ekonomi, dan cakupan jaringan yang dibutuhkan aplikasi.
Pertanyaan yang Sering Diajukan
Apakah Integrasi KyberSwap Aggregator API Gratis?
Ya. Developer dapat mengakses KyberSwap Aggregator API tanpa langganan API berbayar di muka. KyberSwap Swap juga memiliki biaya swap KyberSwap sebesar 0%, tetapi gas jaringan dan biaya dari sumber likuiditas yang mendasarinya tetap dapat berlaku.
Apakah KyberSwap Aggregator API Memerlukan Kunci API?
Ya. Dokumentasi terbaru mengarahkan integrator ke Swap API gateway, dan setiap permintaan harus menyertakan header X-Api-Key. Developer perlu mendapatkan kunci tersebut dari tim KyberSwap / BD.
URL dasar yang lama masih berfungsi, tetapi memiliki batas laju, dan dokumentasi menyarankan migrasi ke jalur gateway.
Jaringan EVM Mana Saja yang Didukung KyberSwap Aggregator API?
KyberSwap mendukung berbagai jaringan EVM, termasuk ekosistem utama seperti Ethereum, Base, BNB Chain, Arbitrum, Optimism, dan Robinhood Chain. Developer sebaiknya memeriksa daftar jaringan yang didukung terbaru sebelum peluncuran karena cakupannya dapat bertambah seiring waktu.
Bisakah Saya Menggunakan Satu Integrasi KyberSwap API di Beberapa Chain EVM?
Ya. Alur umum untuk menemukan rute dan membuat transaksi yang sama dapat digunakan kembali di berbagai jaringan EVM yang didukung. Hal ini mengurangi kebutuhan untuk memelihara arsitektur swap terpisah untuk setiap chain.