Panduan Terbit 2026-11-07 Baca 7 mnt

Mengapa API bursa mengembalikan 403 atau 451: blokir dan wilayah

403 berarti server memahami permintaan Anda dan menolak melaksanakannya. 451 berarti akses ditolak karena alasan hukum. Pada API bursa kripto, 403 bisa berupa firewall web, batas permintaan, kunci tanpa izin, atau blokir wilayah, jadi kodenya saja tidak menunjukkan yang mana. Isi respons, dokumentasi bursa, dan perbandingan dari jaringan lain biasanya menunjukkannya. Pembatasan nyata berlaku pada Anda karena suatu alasan, jadi respons yang benar adalah mencari tahu apakah layanan tersedia di tempat Anda.

Jawaban singkat

Baca isi respons lebih dulu, karena biasanya menyebut alasannya. Binance memakai 403 untuk batas web application firewall, Bybit memakainya untuk «access too frequent», dan banyak bursa memakai 403 atau 451 untuk wilayah terbatas. Jika bursa membatasi negara Anda, memakai alat untuk menyembunyikan lokasi kemungkinan melanggar syaratnya dan bisa membahayakan dana Anda.

Arti umum 403 dan 451

Keduanya kode status HTTP standar. 403 Forbidden menyatakan server menolak permintaan dan mengulanginya tanpa perubahan tidak akan membantu. Kode ini tidak menyebut alasannya. 451 Unavailable For Legal Reasons lebih sempit: referensi MDN menggambarkannya sebagai sumber daya yang tidak tersedia karena alasan hukum, seperti halaman web yang terkena tindakan hukum. Nomor kodenya merujuk pada novel Fahrenheit 451.

Dalam praktiknya, bursa memakai kedua kode ini secara tidak konsisten. 451 adalah sinyal jelas, dan wajar menganggap Anda berada di lokasi terbatas. 403 memerlukan penyelidikan lebih lanjut.

Halaman referensi MDN Web Docs untuk 451 Unavailable For Legal Reasons yang menjelaskan kode status — Referensi MDN untuk HTTP 451. Saat API bursa mengembalikan kode ini, penolakannya menyangkut ketersediaan hukum, bukan permintaan Anda. developer.mozilla.org · 2026-11-07

Penyebab umum 403 pada API bursa

Masing-masing tampak identik dalam log yang hanya mencatat kode status.

Web application firewall. Dokumentasi Binance menyatakan HTTP 403 dipakai saat batas WAF dilanggar. Firewall bisa bereaksi pada pola permintaan, user agent yang tidak biasa, atau rentang IP pusat data.
Blokir laju permintaan. Bybit mengembalikan 403, access too frequent saat IP melampaui batas, dan menyatakan untuk berhenti serta menunggu setidaknya 10 menit.
Pembatasan wilayah. Banyak bursa menolak lalu lintas dari negara tertentu. Pesannya biasanya menyebutkan itu, dalam teks atau bidang JSON.
Izin kunci atau daftar izin IP. Kunci API yang dibatasi pada alamat IP tertentu, atau tanpa izin yang diperlukan, bisa mengembalikan 401 atau 403. Biasanya disertai error yang jelas.
Domain salah untuk akun Anda. Sebagian bursa memisahkan pengguna menurut wilayah.
Blokir CDN atau proksi. Jaringan pengiriman konten di depan bursa bisa menolak permintaan sebelum mencapai bursa. Isinya kemudian halaman HTML, bukan JSON.

Baca isi respons

Inilah langkah paling berguna, dan sering dilewatkan karena pustaka melempar pengecualian pada kode status sebelum ada yang melihat isinya. Catat isinya.

JSON dengan kode error bursa: aplikasi bursa sendiri yang menjawab. Cari kodenya di dokumentasi.
HTML dengan nama CDN, Ray ID, atau pesan keamanan: proksi atau firewall yang menjawab. Aplikasi bursa mungkin tidak pernah melihat permintaan Anda.
Pesan yang menyebut negara atau pembatasan layanan: blokir wilayah. Baca secara harfiah.
Isi kosong: periksa header respons dan coba dari jaringan berbeda untuk membandingkan.

Kami juga harus menyelesaikan masalah ini sendiri. 403 saja tidak memastikan pembatasan negara, jadi pengecekan kami hanya mengklasifikasikan respons sebagai blokir wilayah saat statusnya 451, atau 403 dengan isi yang teksnya menyebut pembatasan. Blokir ini dihitung terpisah dari ketersediaan dan ditampilkan di halaman tiap bursa, karena keputusan hukum bukan insiden.

Domain API regional

Pembatasan wilayah tidak selalu berarti Anda sama sekali tidak bisa memakai layanan. Sebagian bursa menjalankan entitas dan domain terpisah untuk tempat berbeda, dan akun Anda terikat pada salah satunya. Dokumentasi API OKX adalah contoh jelas. Dokumentasi itu menyatakan Anda harus memakai domain yang benar sesuai tempat pendaftaran: pengguna yang mendaftar di app.okx.com di AS dan Australia memakai us.okx.com, dan pengguna di my.okx.com di UE memakai eea.okx.com, dengan dokumentasi terpisah untuk masing-masing. Dokumentasi Bybit juga menyebut hostname situs lokal seperti api.bybit.kz.

Jadi jika permintaan gagal, periksa bahwa Anda memakai domain yang cocok dengan pendaftaran akun. Ini perbaikan yang sah dan hanya perlu mengikuti dokumentasi.

Server cloud dan reputasi IP

Program yang berjalan di laptop bisa gagal di server cloud, bahkan di negara yang sama. Alasannya antara lain:

Lokasi server. Wilayah cloud di negara terbatas akan ditolak, meski Anda tinggal di tempat lain. Bursa bisa melihat geolokasi IP, bukan di mana Anda berada.
Riwayat alamat bersama. IP baru Anda mungkin pernah dipakai seseorang yang menyalahgunakan API, dan firewall mungkin mengingatnya.
Kesalahan geolokasi. Basis data yang memetakan IP ke negara bisa salah. Bursa dan penyedia cloud kadang tidak sepakat tentang lokasi suatu rentang.
Pola lalu lintas otomatis. Sebagian endpoint publik berada di balik perlindungan terhadap bot. Permintaan yang rapi, laju yang wajar, dan hostname API resmi semuanya membantu.

Pilih lokasi server tempat bursa benar-benar menawarkan layanannya. Jika ragu, periksa syarat dan daftar negara terbatasnya sebelum menerapkan apa pun. Lalu jalankan tes di bawah dari server, bukan dari laptop.

Apakah blokirnya nyata? Cara mengujinya

Buat permintaan publik tanpa kunci dari mesin yang terdampak, seperti endpoint waktu server bursa, dan simpan status serta isinya.
Ulangi dari jaringan berbeda di negara yang sama, seperti koneksi seluler, jika ada.
Bandingkan hasilnya dengan halaman status bursa dan pembacaan independen seperti halaman bursa kami.
Jika hanya permintaan bertanda tangan yang gagal, masalahnya izin kunci, daftar izin IP, atau tanda tangan, bukan blokir.
Jika respons menyebut wilayah dan syarat bursa mencantumkannya, perlakukan ini sebagai jawaban akhir.

Berhati-hatilah menarik kesimpulan. Hasil dari satu lokasi menggambarkan rute itu. Pengukuran kami berasal dari satu lokasi yang disebutkan, jadi bursa yang memblokir lokasi itu akan muncul di halamannya sebagai penolakan wilayah, yang tidak menyatakan apa pun tentang apakah Anda bisa memakainya.

Yang tidak boleh dilakukan terhadap blokir wilayah

Saat bursa membatasi negara Anda, godaannya adalah mengakali dengan VPN atau proksi. Kami tidak menyarankannya, dan bukan sekadar formalitas. Ada alasan praktis.

Kemungkinan melanggar syarat yang Anda setujui. Kebanyakan bursa melarang memalsukan lokasi.
Membahayakan dana Anda. Bursa bisa membatasi atau menutup akun yang kedapatan melakukan ini, dan mengambil kembali uang mungkin memerlukan pengecekan identitas yang mengungkap ketidakcocokan.
Bisa berakibat hukum tergantung tempat tinggal Anda, dan aturan ini sedang berubah di banyak negara.
Rapuh. Sistem trading yang bergantung pada proksi punya titik kegagalan tambahan pada saat terburuk.

Jalan yang lebih baik adalah mencari layanan berlisensi yang tersedia di tempat Anda. Jika merasa wilayah Anda salah terdeteksi, hubungi bursa lewat dukungan resmi dan tanyakan. Anda kecil kemungkinan mendapat penyelesaian cepat, dan sebaiknya menjaga uang tetap aman sementara itu.

Cara menangani kode ini dalam kode

Jangan mengulang 403 atau 451 secara membabi buta. Kode ini umumnya tidak hilang dengan percobaan cepat, dan pengulangan bisa memperburuk blokir firewall. Perlakukan berbeda dari 5xx.
Catat status, header, dan isi. Potong isi ke panjang aman, dan jangan pernah mencatat rahasia. Potongan pendek isi biasanya mengidentifikasi penyebabnya.
Pisahkan kategori dalam pemantauan. Penolakan wilayah dan kegagalan server berarti hal berbeda. Menggabungkannya membuat angka ketersediaan tidak bermakna.
Beri tahu manusia pada 403 baru. Biasanya menandai perubahan yang perlu Anda ketahui, seperti kebijakan baru atau kunci yang dibatasi.
Mundur pada blokir frekuensi gaya Bybit. Panduan batas laju kami membahas respons yang tepat dalam situasi itu.

Pertanyaan umum tentang 403 dan 451

Apakah 403 dari bursa sama dengan diblokir permanen?

Belum tentu. Bisa sementara, seperti blokir berbasis laju, atau berasal dari lokasi server dan bukan dari yang Anda lakukan. Pembatasan akun permanen biasanya tampak berbeda, lewat halaman akun atau pesan dari bursa.

Mengapa endpoint data pasar publik juga diblokir?

Sebagian bursa menerapkan aturan wilayah di tepi jaringan, sebelum melihat endpoint mana yang diminta. Itulah mengapa blokir bisa muncul pada endpoint publik tanpa kunci. Itu juga alasan pengukuran kami mengeluarkan respons itu dari ketersediaan, bukan melaporkan bursa down.

Apa beda 401 dan 403?

401 umumnya berarti autentikasi hilang atau tidak valid, jadi kredensial yang benar bisa mengubah hasilnya. 403 umumnya berarti server tahu siapa Anda, atau tidak perlu tahu, dan tetap menolak. Bursa tidak selalu mengikuti pembedaan ini secara ketat, jadi periksa isi dan tabel kode errornya.

Mengapa endpoint yang berfungsi di browser mengembalikan 403 di kode saya?

Browser dan kode Anda terlihat berbeda. User agent, header, alamat IP, dan frekuensi permintaannya berbeda, dan firewall bisa bereaksi pada hal-hal itu. Pastikan dulu Anda mengirim header yang diminta dokumentasi dan memakai hostname API resmi. Memakai alamat halaman web seolah-olah API adalah penyebab umum masalah ini.

Bagaimana cara melaporkan blokir ke bursa?

Kirim kode status lengkap, isi respons, waktu, dan alamat IP Anda ke saluran dukungan resmi. Jangan pernah membagikan kunci rahasia. Sertakan pengenal seperti Ray ID jika ada, karena sering memudahkan mereka menemukan permintaannya.

Menangani penolakan

Catat status lengkap, header, dan isi respons.
Periksa apakah isi berasal dari bursa atau proksi.
Cari kode error di dokumentasi bursa.
Pastikan Anda memakai domain yang benar untuk wilayah akun.
Uji endpoint publik dari jaringan lain.
Baca daftar lokasi terbatas bursa.
Berhenti mengulang sampai memahami penyebabnya.

Singkatnya, 403 adalah titik awal, bukan diagnosis. Angka dalam panduan ini untuk menunjukkan metodenya dan bukan nasihat investasi. Untuk keputusan Anda, ambil nilai terkini dari halaman resmi bursa, ulangi perhitungan dengan posisi Anda sendiri, dan bandingkan hasilnya dengan riwayat transaksi. Jika Anda melihat kesalahan pada data kami, tulis ke alamat di halaman tentang kami; koreksi kami terbitkan dengan menjelaskan apa yang berubah dan mengapa.

Bacaan terkait: Batas laju API bursa dan error 429 · Cara memeriksa apakah bursa down · Cara membaca uptime API dan catatan insiden

Sumber

MDN · 451 · Binance · Kode kembali HTTP · Bybit · Aturan batas laju · OKX · Dokumentasi API · Cara kami mengukur · Tentang Tickmark

Panduan lain

Apa itu funding rate pada perpetual futures kripto? Penjelasan sederhana

Funding rate adalah pembayaran rutin antara trader yang memegang sisi berlawanan pada kontrak perpetual futures. Kontrak ini ada karena perpetual tidak pernah jatuh tempo, sehingga perlu mekanisme lain untuk menjaga harganya tetap dekat dengan aset dasarnya. Saat rate positif, long membayar short; saat negatif, short membayar long. Bursa menetapkan rumusnya, tetapi di bursa-bursa besar uang itu berpindah antar trader.

Cara membandingkan funding rate antar bursa: penyelesaian 8 jam vs 4 jam

Anda tidak bisa membandingkan dua funding rate hanya dari persentasenya. Sebuah rate baru bermakna setelah Anda tahu seberapa sering dikenakan, apakah Anda long atau short, dan apakah kedua pembacaan menggambarkan kontrak yang sama pada saat yang sama. +0,01% yang sama berbiaya dua kali lipat per hari pada jadwal empat jam dibanding jadwal delapan jam, dan apa yang menjadi biaya long adalah pendapatan bagi short.

Apa arti funding rate negatif? Siapa membayar, dan apa yang tidak disampaikannya

Funding rate negatif berarti trader yang memegang posisi short membayar trader yang memegang posisi long pada penyelesaian berikutnya. Biasanya ini terjadi saat kontrak perpetual diperdagangkan di bawah harga indeksnya, yang sering mencerminkan shorting besar-besaran atau lindung nilai. Rate negatif tidak berarti harga akan segera turun atau naik, dan bukan pendapatan gratis bagi long, karena harga bisa bergerak melawan mereka jauh melebihi pembayarannya.

Cara mengubah funding rate menjadi APR, dan mengapa angkanya bisa menyesatkan

Untuk menyetahunkan funding rate, kalikan rate per penyelesaian dengan jumlah penyelesaian dalam sehari, lalu dengan 365. Rate 0,01% setiap delapan jam menjadi 0,01% × 3 × 365 = 10,95% setahun. Ini menempatkan kontrak dengan jadwal berbeda pada satu skala, sehingga bisa dibandingkan. Angka itu tidak memberi tahu berapa yang akan Anda peroleh atau bayar dalam setahun, karena mengasumsikan rate hari ini tidak pernah berubah.

Arbitrase funding rate: cara kerjanya dan apa yang menggerus keuntungan

Arbitrase funding rate berarti memegang dua posisi yang saling mengimbangi pada aset yang sama sehingga pergerakan harga kurang lebih saling meniadakan, sambil mengumpulkan pembayaran funding di satu sisi. Versi klasiknya membeli spot dan short perpetual. Versi kedua melakukan short perpetual di bursa dengan rate lebih tinggi dan long di bursa dengan rate lebih rendah. Strategi ini sering disebut bebas risiko. Padahal tidak. Risikonya hanya berbeda dari trade berarah biasa.

Harga mark vs harga terakhir vs harga indeks: mana yang melikuidasi Anda?

Perpetual futures menampilkan tiga harga yang mudah tertukar. Harga terakhir adalah tempat transaksi terbaru terjadi. Harga indeks adalah rata-rata harga spot di beberapa bursa. Harga mark adalah perkiraan bursa tentang nilai wajar kontrak, dan di bursa-bursa besar harga inilah yang menentukan keuntungan belum terealisasi dan apakah Anda dilikuidasi. Mengetahui fungsi tiap harga menjelaskan mengapa posisi bisa dilikuidasi meski grafik tidak pernah menyentuh level likuidasi Anda.

Berapa biaya market order sebenarnya: biaya transaksi, spread, dan slippage

Biaya di halaman tarif bursa hanyalah sebagian dari biaya market order. Sisanya berasal dari harga yang benar-benar Anda dapat, yang bergantung pada arah trade, ukuran order, dan kedalaman order book saat itu. Untuk membandingkan bursa secara adil, ukur harga isi rata-rata terhadap satu harga acuan, lalu tambahkan biaya transaksi, dan berhati-hatilah agar tidak menghitung spread dua kali.

Cara memperkirakan slippage dari kedalaman order book sebelum bertransaksi

Slippage adalah selisih antara harga yang Anda harapkan dan harga rata-rata yang benar-benar Anda dapat. Sebagian besar bisa diperkirakan sebelum menempatkan order, karena order book menunjukkan berapa yang tersedia di tiap harga. Jumlahkan tingkat di sisi yang akan Anda konsumsi sampai menutup ukuran Anda, hitung harga rata-rata, dan bandingkan dengan harga tengah. Perkiraan hanya sebaik potret asalnya, dan order book menipis pada saat Anda paling mungkin membutuhkannya.

Biaya maker dan taker: cara membandingkan biaya transaksi bursa kripto

Maker menambahkan order ke order book yang menunggu terisi. Taker mengisi terhadap order yang sudah ada di sana. Kebanyakan bursa mengenakan lebih banyak pada taker, karena maker menyediakan likuiditas yang menjadi lawan transaksi orang lain. Membandingkan bursa hanya dari biaya utama menyesatkan: Anda perlu tahu sisi mana yang biasanya Anda pakai, tingkat apa yang sebenarnya berlaku untuk volume Anda, dan bagaimana biaya itu dibanding slippage serta funding pada trade yang sama.

Cara memeriksa apakah bursa kripto sedang down: panduan langkah demi langkah

Saat bursa berhenti berfungsi bagi Anda, pertanyaan pertama adalah apakah bursa itu down untuk semua orang atau hanya untuk Anda. Biasanya bisa dijawab dalam beberapa menit: periksa halaman status bursa, periksa pengukuran independen, coba jaringan lain, dan uji API publik langsung. Setiap sumber melihat hal berbeda, jadi satu halaman hijau tidak membuktikan semuanya baik, dan satu permintaan gagal tidak membuktikan bursa down.

Apakah bursa benar-benar down? Cara membaca uptime API dan catatan insiden

Uptime menggambarkan porsi permintaan yang berhasil ke layanan tertentu, selama periode tertentu, dari rute jaringan tertentu. Uptime tidak memastikan Anda bisa menempatkan order, menarik dana, atau memercayakan aset pada suatu bursa. Angka seperti 99,9% hanya berguna jika Anda tahu apa yang diuji, dari mana, dan berapa lama, jadi panduan ini menjelaskan cara membaca detail itu di halaman kami dan di tempat lain.

Apa yang harus dilakukan saat bursa kripto down ketika Anda punya posisi terbuka

Jika bursa berhenti merespons saat Anda memegang posisi, tugas pertama adalah mencari tahu apa yang sebenarnya rusak, kedua jangan memperburuknya, dan ketiga mengurangi risiko lewat jalur apa pun yang masih berfungsi. Jangan terus mengirim ulang order yang sama, karena percobaan sebelumnya mungkin sudah berhasil. Periksa aplikasi seluler dan API sebagai jalur alternatif, pertimbangkan lindung nilai di tempat lain jika eksposur besar, dan catat kejadiannya jika nanti perlu diajukan.

Mengapa API bursa menolak timestamp: selisih jam dan kuotasi basi

Respons cepat bisa berisi kuotasi lama. Latensi pulang-pergi, selisih jam, dan umur kuotasi menggambarkan bagian berbeda dari suatu permintaan, dan mencampurnya bisa membuat ketidakcocokan jam tampak seperti umpan pasar yang terlambat. Panduan ini menjelaskan masing-masing dengan contoh, menunjukkan cara kami memperkirakannya, dan membahas yang harus dilakukan saat API bursa menolak permintaan Anda karena waktu.

Error Binance -1021 timestamp: penyebab dan cara memperbaikinya

Error API Binance -1021 INVALID_TIMESTAMP berarti timestamp pada permintaan bertanda tangan Anda berada di luar jendela yang diterima Binance. Pesannya biasanya Timestamp for this request is outside of the recvWindow atau was 1000ms ahead of the server's time. Dalam kebanyakan kasus jam Anda sendiri penyebabnya, jadi solusinya adalah menyinkronkannya, mengukur selisih terhadap waktu server Binance, dan menangani sisa jeda jaringan dengan benar. recvWindow lebih besar bisa menyembunyikan masalah, tetapi tidak boleh menjadi langkah pertama.

Batas laju API bursa kripto: arti error 429 dan cara tetap di bawahnya

HTTP 429 berarti Anda mengirim terlalu banyak permintaan dalam waktu tertentu, dan server meminta Anda melambat. Ini bukan insiden. Setiap bursa menghitung permintaan secara berbeda: Binance memakai bobot untuk tiap endpoint dan memblokir alamat IP yang terus berlanjut setelah 429, Bybit memblokir IP yang melewati 600 permintaan dalam lima detik, dan OKX menetapkan batas per endpoint serta mengembalikan kode error 50011. Tetap di bawah batas berarti membaca header respons, mundur dengan benar, dan memakai WebSocket jika bisa.

Sebelum membuka akun bursa kripto di Indonesia: daftar cek

Sebelum membuka akun di bursa kripto, cek empat hal: apakah bursa itu boleh melayani orang di tempat Anda tinggal, apakah regulator di negara Anda memberinya izin, apakah situs di depan Anda adalah situs yang asli, dan bagaimana bursa itu berjalan belakangan ini. Mengisi formulir pendaftaran hanya butuh sepuluh menit. Memperbaiki pilihan yang salah bisa makan waktu berbulan-bulan, dan kadang tidak bisa diperbaiki sama sekali. Panduan ini membahas setiap pengecekan satu per satu, dengan Binance dan OKX sebagai contoh karena keduanya paling sering ditanyakan pembaca kami, serta menjelaskan kondisi di Indonesia pada November 2026.