SwapSpace API vs. Changelly API: perbandingan lengkap untuk developer

Menambahkan fungsi swap ke wallet atau produk Web3 berdampak jauh lebih besar daripada sekadar pengalaman pengguna. API yang dipilih menentukan bagaimana backend meminta quote, menangani rate yang kedaluwarsa, melacak transaksi, dan merespons ketika suatu rute tidak tersedia. Ini juga membentuk beban dukungan saat sebuah exchange tertunda, direfund, atau dijeda untuk verifikasi.

Perbandingan Changelly API vs SwapSpace API ini menelaah perbedaan teknis yang penting bagi developer yang membangun wallet, exchange, dan produk Web3 lainnya.

Perbandingan ini menggunakan dokumentasi publik masing-masing penyedia dan halaman B2B terkini. Ketersediaan aset, batas permintaan, ketentuan komersial, dan aturan kepatuhan dapat berubah. Pastikan melalui API live dan perjanjian mitra Anda sebelum peluncuran.

Apa itu Changelly API?

Changelly API v2 adalah cryptocurrency exchange API white-label yang mengekspos satu layanan quote dan transaksi dari Changelly.

• Protokol: JSON-RPC 2.0 melalui permintaan POST yang ditandatangani.
• Autentikasi: X-Api-Key ditambah tanda tangan RSA-SHA256, dengan akun partner dan pendaftaran public key.
• Model rate: metode fixed-rate dan floating-rate terpisah.
• Cakupan aset: lebih dari 1.000 aset di halaman B2B publik, dengan set yang aktif di live dikembalikan oleh API.
• Produk terkait: layanan fiat API, widget, dan checkout terpisah.

API ini menempatkan pemilihan penyedia di luar aplikasi. Estimasi fixed dan floating menggunakan metode yang berbeda, dan quote fixed memiliki jendela validitas yang singkat. Perbedaan ini terbawa ke langkah pembuatan transaksi. Perbedaan implementasi utamanya adalah penandatanganan permintaan, bukan pemeringkatan rute.

Apa itu SwapSpace API?

SwapSpace API v2 adalah REST API yang mengekspos penawaran dari beberapa partner exchange melalui satu integrasi.

• Protokol: endpoint REST khusus resource untuk mata uang, partner, jumlah, pembuatan exchange, dan status.
• Autentikasi: API key di header Authorization, dengan batas permintaan yang dikonfigurasi untuk tiap affiliate.
• Model rate: penawaran fixed dan floating, filter partner, dan opsi Best Amount.
• Cakupan aset: lebih dari 3.600 aset di 675 jaringan dan lebih dari 40 sumber likuiditas di halaman B2B publik, dengan validasi rute live yang diperlukan.
• Produk terkait: exchange widget dan transfer privat, dengan akses transfer privat yang dikonfirmasi terpisah.

Setiap penawaran membawa data partner dan rute. Aplikasi dapat menampilkan beberapa penawaran, memfilternya, atau memakai metode seleksi yang lebih sederhana. ID penawaran mungkin berumur pendek, dan metadata penyedia dapat mengubah persyaratan alamat refund. Data pada level rute inilah perbedaan arsitektural utama dibanding kontrak layanan tunggal Changelly.

Perbandingan Changelly API vs SwapSpace API secara singkat

Perbandingan exchange API comparison ini berfokus pada permukaan integrasi yang dapat diverifikasi developer dalam dokumentasi publik.

Arsitektur likuiditas: API penyedia tunggal vs aggregator

Pemilihan quote dan transparansi

Changelly dapat mengambil likuiditas melalui infrastrukturnya sendiri, tetapi API partner mengekspos Changelly sebagai batas layanan. Aplikasi Anda meminta estimasi dan menerima satu hasil untuk metode dan pair yang diminta. Ini membuat model quote tetap ringkas. Produk tidak perlu memberi peringkat pada penyedia atau menjelaskan mengapa dua penyedia memberikan limit yang berbeda.

SwapSpace mengekspos liquidity aggregation secara langsung. Endpoint amounts dapat mengembalikan penawaran dari semua partner yang tersedia atau dari daftar partner yang dipilih. Respons dapat mencakup rute fixed dan floating untuk pair yang sama. Ini memberi wallet atau exchange kontrol lebih besar atas sorting. Produk dapat melakukan ranking berdasarkan jumlah tujuan, estimasi durasi, kebijakan penyedia, atau aturan bisnisnya sendiri.

Jika audiens menghargai pilihan penyedia atau transparansi rute, integrasi SwapSpace dapat menampilkan beberapa penawaran dan menerapkan aturan seleksi khusus produk. Produk yang lebih sederhana dapat mengekspos satu rute terpilih. Identitas penyedia, jenis rate, limit, dan durasi yang diharapkan tetap tersedia saat antarmuka membutuhkannya.

Ketersediaan dan perilaku fallback

Dengan Changelly, jika suatu mata uang dinonaktifkan atau estimasi gagal, API tidak mengekspos penyedia lain yang bernama melalui kontrak yang sama. Aplikasi membutuhkan integrasi terpisah untuk memilih rute lain.

Sebelum pembuatan exchange, SwapSpace dapat mengembalikan penawaran dari partner lain yang tersedia. Setelah exchange dibuat, penyedia yang dipilih tetap terikat pada transaksi tersebut. Karena itu, Changelly memusatkan ketergantungan rute dalam satu layanan. SwapSpace mengekspos fallback sebelum transaksi dalam API yang sama.

Batasan kepatuhan dan dukungan

Kedua API dapat menampilkan status terkait verifikasi, tetapi tanggung jawabnya dibagi secara berbeda. 

Changelly mendokumentasikan status hold dan mengarahkan partner untuk mengirim pengguna ke tim keamanannya. 

SwapSpace mengekspos status Verifying, sementara penyedia exchange yang dipilih mungkin mengendalikan pengecekan. Identitas penyedia dan instruksi dukungan karena itu menjadi lebih penting dalam model agregasi.

Pengalaman developer

Akses dan autentikasi

Autentikasi adalah perbedaan implementasi yang paling jelas dan membentuk tahap pertama dari crypto swap integration.

Changelly:

• Akun partner dan pendaftaran public key.
• Tanda tangan RSA-SHA256 untuk setiap body permintaan JSON-RPC.
• Integrasi sisi server untuk melindungi private key.

SwapSpace:

• Akun affiliate dan API key di header Authorization.
• Batas permintaan dikonfigurasi untuk affiliate saat onboarding.
• Penyimpanan API key di sisi server.

Changelly membutuhkan setup dan kode penandatanganan yang lebih banyak. SwapSpace menggunakan model kredensial yang lebih ringan, sementara kapasitas produksi bergantung pada konfigurasi affiliate.

Dokumentasi dan penanganan error

Changelly documentation:

• Skema permintaan di level method dan contoh error.
• Contoh autentikasi dalam beberapa bahasa pemrograman.
• Catatan migrasi dan referensi status yang detail.

SwapSpace documentation:

• Alur REST singkat dari mata uang dan partner ke status exchange.
• Aturan validasi untuk jumlah, rate ID, extra ID, IP pengguna, dan alamat refund bersyarat.

Changelly menyediakan materi autentikasi dan error yang lebih mendalam. SwapSpace mendokumentasikan alur yang lebih singkat dengan lebih banyak data pemilihan rute.

Respons JSON-RPC Changelly mengekspos kode dan pesan khusus method. Alur REST SwapSpace mendokumentasikan field validasi seperti network ID, rate ID, extra ID, IP pengguna, dan alamat refund bersyarat. Petakan kegagalan upstream ini ke kategori internal yang stabil sebelum mencapai antarmuka. Simpan kode error asli dan exchange ID di log agar support dapat menelusuri rute tanpa menampilkan pesan mentah dari penyedia kepada pengguna.

Pertimbangan performa dan skalabilitas

Changelly mempublikasikan batas default 10 permintaan per detik untuk metode yang relevan. Ketentuan throughput yang lebih tinggi tidak ditentukan dalam referensi publik.

SwapSpace tidak mempublikasikan batas numerik standar karena batas permintaan dikonfigurasi untuk setiap affiliate. Karena itu, perencanaan kapasitas bergantung pada konfigurasi partner yang disepakati, bukan default publik.

Kedua alur publik mengekspos endpoint status berbasis polling. Referensi publik yang ditinjau untuk perbandingan ini tidak mendefinisikan kontrak webhook umum, sehingga ketersediaan webhook tetap menjadi bagian dari onboarding partner.

Perilaku polling juga memengaruhi perencanaan kapasitas. Cache mata uang dan metadata partner untuk interval yang ditentukan, hindari me-refresh quote yang tidak dapat segera ditindaklanjuti pengguna, dan kurangi frekuensi pengecekan status setelah transaksi melewati tahap yang sensitif terhadap waktu. Load test harus mencakup lonjakan quote, ID kedaluwarsa, pair yang dinonaktifkan, dan kegagalan di sisi penyedia. Benchmark seluruh jalur kegagalan, bukan hanya satu angka latensi: produk harus tetap responsif saat rute menghilang atau respons upstream melambat.

Dukungan dan eskalasi

Untuk crypto exchange API for developers, cakupan dukungan paling penting saat transaksi macet atau masuk verifikasi. 

Changelly mengarahkan pertanyaan teknis ke email partner atau dedicated account manager. Dokumentasinya menjelaskan model eskalasi di mana partner memberikan dukungan lini pertama dan mengirim kasus yang belum terselesaikan ke tim level dua Changelly melalui channel Slack khusus.

SwapSpace menyediakan email partner dan formulir kontak B2B, bersama dukungan pengguna 24/7. Jalur eskalasi dan komitmen respons bergantung pada perjanjian partner.

Sebelum mengintegrasikan salah satu API, pastikan jam dukungan, notifikasi insiden, akses status page, dan data yang diperlukan untuk menyelidiki exchange yang macet.

Ketentuan komersial dan model pendapatan

Tidak ada crypto exchange API yang mengenakan biaya integrasi publik. Keduanya mendukung monetisasi partner melalui fee tambahan atau model revenue-sharing.

Changelly memungkinkan partner API menambahkan fee ke exchange rate. business FAQ-nya menyebut 0,1% hingga 5% sebagai kisaran umum, sementara API documentation saat ini mengatakan bahwa fee dikonfigurasi melalui tim partner.

Endpoint pembuatan exchange milik SwapSpace menyertakan parameter opsional affiliateFee. Tarif affiliate fee bergantung pada penyedia likuiditas yang dipilih dan perjanjian partner.

Alur integrasi

Langkah-langkah di bawah membandingkan kedua alur crypto swap API dan pekerjaan engineering yang diperlukan masing-masing crypto API integration.

Integrasi Changelly yang umum

1. 1. Buat akun partner Changelly dan hasilkan public key serta private key.
2. 2. Daftarkan public key ke Changelly dan simpan private key di secret store sisi server.
3. 3. Implementasikan serialisasi permintaan JSON-RPC 2.0 dan penandatanganan RSA-SHA256.
4. 4. Ambil data mata uang yang diaktifkan dan petakan ticker, network, field memo, dan aturan validasi.
5. 5. Minta estimasi floating atau fixed, lalu validasi jumlah dan limit yang dikembalikan.
6. 6. Buat tipe transaksi yang benar sebelum quote atau jendela pembayaran kedaluwarsa.
7. 7. Simpan ID transaksi dan lakukan polling getStatus atau getTransactions dengan backoff.
8. 8. Petakan setiap state terminal, refund, kedaluwarsa, dan verifikasi ke pesan pengguna dan prosedur support.

Changelly menerapkan dua batasan protokol: tanda tangan harus cocok dengan body ter-serialize secara persis, dan estimasi v2 harus tetap berpasangan dengan metode transaksi v2.

💡 Penting! Alur fixed dan floating menggunakan metode yang berbeda, jadi harus diuji secara terpisah.

Integrasi SwapSpace yang umum

1. 1. Buat akun affiliate, peroleh API key, dan konfirmasi allowance permintaan untuk environment target.
2. 2. Ambil daftar mata uang dan pertahankan identifier aset dan jaringan yang terpisah.
3. 3. Ambil daftar partner dan simpan persyaratan rute seperti aturan alamat refund.
4. 4. Minta jumlah yang tersedia untuk pair, jumlah, jaringan, dan tipe rate yang diperlukan.
5. 5. Beri peringkat penawaran yang dikembalikan atau minta endpoint Best Amount sesuai kebijakan seleksi produk.
6. 6. Validasi nilai minimum dan maksimum, lalu buat exchange sebelum ID rate yang dikembalikan kedaluwarsa.
7. 7. Simpan ID exchange SwapSpace, penyedia yang dipilih, dan data transaksi yang terlihat oleh pengguna.
8. 8. Lakukan polling ke endpoint status dengan backoff dan tangani state finished, failed, refunded, verifying, dan expired.

SwapSpace mengikat penawaran yang dipilih ke exchange yang dibuat. Quote atau penyedia baru akan menghasilkan permintaan exchange baru.

💡 Penting! Jika quote kedaluwarsa sebelum exchange dibuat, pengguna harus menyetujui penawaran yang telah diperbarui.

API mana yang cocok untuk produk yang berbeda?

Tim yang mengevaluasi crypto API for wallet harus terlebih dahulu memutuskan apakah pengguna membutuhkan satu hubungan exchange atau pilihan penyedia yang terlihat.

Tabel ini memperlakukan kecocokan produk sebagai hipotesis awal. Ketentuan komersial, wilayah, permintaan aset, trafik, dan kapasitas engineering internal dapat mengubah hasilnya.

Kapan Changelly API masuk akal

Changelly API cocok untuk produk yang menginginkan satu layanan exchange dan respons quote yang ringkas.

Contoh penandatanganan yang detail dan dokumentasi error di level method membantu tim yang menghargai lapisan autentikasi yang terdefinisi jelas. Ini juga cocok untuk perusahaan yang berencana mengevaluasi produk fiat atau checkout terpisah dari Changelly dalam hubungan B2B yang sama.

Tradeoff-nya adalah visibilitas rute. API mengembalikan estimasi Changelly, bukan daftar penyedia exchange bernama. Integrasinya juga memerlukan pendaftaran public key saat onboarding.

Kapan SwapSpace API masuk akal

SwapSpace lebih cocok ketika perbandingan penyedia menjadi bagian dari produk. API ini mengekspos beberapa penawaran, opsi fixed dan floating, filter partner, dan metadata rute melalui satu REST API. Halaman B2B-nya mencantumkan lebih dari 40 sumber likuiditas dan 3.600+ aset di 675 jaringan. Nilainya adalah cakupan rute long-tail dan lintas-chain yang lebih luas melalui satu kontrak.

Jika suatu produk mengambil beberapa penawaran dan memilih rute sendiri, integrasinya mungkin memerlukan kriteria seleksi yang eksplisit, penanganan kedaluwarsa quote, dan data exchange spesifik penyedia. Produk yang menggunakan Best Amount atau alur yang lebih sederhana dapat menyimpan lebih banyak logika routing itu di luar antarmuka pengguna.

Putusan akhir

Tidak ada satu best swap API untuk semua kasus. 

Changelly menggunakan JSON-RPC 2.0, penandatanganan permintaan RSA-SHA256, dan model quote dari satu penyedia. API ini menawarkan dokumentasi method dan error yang detail, tetapi tidak mengekspos rute penyedia pesaing melalui API yang sama. 

SwapSpace menggunakan REST dengan autentikasi API-key dan mengembalikan penawaran dari beberapa partner exchange, sehingga memberi produk lebih banyak kontrol atas pemilihan rute dan cakupan aset yang lebih luas.

Pilih Changelly untuk produk yang lebih menyukai satu hubungan penyedia, alur quote yang ringkas, dan dokumentasi detail di level method. Pilih SwapSpace untuk wallet, exchange, dan produk Web3 yang membutuhkan perbandingan penyedia, agregasi likuiditas, atau cakupan rute long-tail yang lebih luas.

Mulai integrasi SwapSpace API Anda

Kirim formulir di halaman B2B SwapSpace untuk membahas akses, batas permintaan, dan kebutuhan integrasi dengan tim produk dan business development. 

Pertanyaan yang sering diajukan

Apa perbedaan antara SwapSpace API dan Changelly API?

Changelly mengekspos layanan exchange white-label melalui JSON-RPC 2.0. Aplikasi menerima estimasi Changelly dan membuat transaksi Changelly. SwapSpace mengekspos beberapa penawaran partner melalui REST API, memungkinkan aplikasi membandingkan atau memfilter rute sebelum membuat exchange.

Apakah SwapSpace API mengagregasi beberapa penyedia likuiditas?

Ya. Endpoint amounts dapat mengembalikan penawaran dari semua partner yang tersedia atau memfilter berdasarkan partner yang dipilih. Halaman B2B publik mencantumkan lebih dari 40 sumber likuiditas. Ketersediaan bervariasi menurut aset, jaringan, jumlah, jenis rate, dan kondisi penyedia saat ini.

API mana yang lebih baik untuk crypto wallet?

Itu tergantung pada desain produk wallet. Changelly cocok untuk wallet yang menginginkan satu quote dan satu hubungan penyedia. SwapSpace cocok untuk wallet yang menginginkan perbandingan penyedia, cakupan rute yang lebih luas, atau logika pemeringkatan penawarannya sendiri. Kecocokan juga bergantung pada cakupan pair yang umum dan long-tail pada wallet tersebut.

Bisakah saya mengintegrasikan swap crypto tanpa membangun exchange sendiri?

Ya. Kedua API memungkinkan produk mengalihkan eksekusi exchange sementara tetap mempertahankan kontrol atas antarmuka dan orkestrasi backend-nya. Validasi alamat, penanganan status, dan dukungan tetap menjadi bagian dari integrasi produk.

Apakah SwapSpace API mendukung fixed dan floating rates?

Ya. Endpoint amounts menerima filter fixed dan float dan dapat mengembalikan kedua tipe dalam satu permintaan. Dukungan bergantung pada partner dan pair. Beberapa penawaran menyertakan rate ID yang berumur pendek yang harus digunakan saat pembuatan exchange.

Berapa lama waktu yang dibutuhkan integrasi API pada umumnya?

Estimasi marketing publik bukan rencana proyek yang andal. Proof of concept sederhana mungkin memakan waktu beberapa hari, sedangkan waktu produksi bergantung pada persetujuan kunci, review keamanan, pekerjaan antarmuka, status kepatuhan, analytics, dan tooling dukungan.

_______

Perbandingan ini hanya untuk tujuan informasi. Fungsi API, cakupan aset, batas, fee, dan persyaratan kepatuhan dapat berubah. Tinjau dokumentasi terkini dan ketentuan kontrak sebelum menerapkan API cryptocurrency exchange untuk produksi.