Memeriksa apakah suatu simbol koin dikenal oleh platform
Memeriksa apakah suatu simbol koin dikenal oleh platform
/api/coin-existsPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| coin | string | Opsional | — | — | Simbol koin; jika kosong mengembalikan exists:false. Contoh: BTC |
Contoh permintaan
curl -s "https://www.coinboss.com/api/coin-exists?coin=BTC"Kolom respons
Tabel kolom dihasilkan dari respons nyata, sehingga memuat persis apa yang dikembalikan endpoint. Path memakai a[] untuk item array dan {*} untuk objek yang kuncinya berupa nama dinamis seperti koin atau bursa.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| exists | boolean | — | true jika simbol koin ada dalam daftar koin atau memiliki setidaknya satu catatan likuidasi; false untuk simbol yang kosong atau tidak dikenal. |
| source | string | — | Asal nilai tersebut. |
Dihasilkan 2026-11-11 23:01 UTC dari 4 respons nyata.
Contoh respons
/api/coin-exists?coin=BTC · Respons nyata yang direkam 2026-11-13 03:59:30 UTC.
- "success"true
- "exists"true
- "source""coins"
Sampel terverifikasi
Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.
| Parameter | HTTP | Latensi | Hasil |
|---|---|---|---|
| coin=ETH | 200 | 3 ms | Lolos |
| coin=SOL | 200 | 4 ms | Lolos |
| coin=ARKM | 200 | 1 ms | Lolos |
Diperiksa 2026-11-13 03:59:30 UTC
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 5m
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- daftar induk koin diperbarui setiap 6 h (2.500 teratas setiap jam); cache API 300 s
- Sumber data
- Pemeriksaan keberadaan terhadap daftar induk koin (daftar koin lengkap agregator data pasar pihak ketiga) dengan cadangan berupa simbol apa pun yang pernah terlihat di stream likuidasi.
- Cakupan bursa
- Sekitar 16.500 koin dari agregator data pasar pihak ketiga ditambah simbol yang teramati di feed likuidasi
- Paginasi
- tidak ada
- Metode
- exists = symbol found in coins (source="coins") else in liquidations (source="liquidations")
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
Ketersediaan, 30 hari terakhir
99.75% dari 408 pemeriksaan lolos
Error
Panggilan yang gagal memiliki satu bentuk yang sama di semua endpoint. Daftar lengkapnya ada di halaman error. Error dan batas permintaan →
| Kode | HTTP | Arti | Tindakan |
|---|---|---|---|
| INVALID_PARAM | 400 | Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui. | Jangan mengulang tanpa perubahan; perbaiki permintaannya. |
| UNAUTHORIZED | 401 | Header `CB-API-KEY` dikirim tetapi kuncinya tidak dikenal atau sudah dicabut. Data publik tidak memerlukan kunci — hapus header tersebut atau gunakan kunci yang valid. | Jangan mengulang tanpa perubahan. |
| FORBIDDEN | 403 | Rute ini bukan bagian dari API publik (internal atau khusus akun). | Jangan mengulang. |
| NOT_FOUND | 404 | Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada. | Jangan mengulang; periksa path dan pengenal terhadap katalog. |
| RATE_LIMITED | 429 | Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu. | Tunggu selama `Retry-After`, lalu ulangi dengan backoff. |
| INTERNAL | 500 | Error server yang tidak terduga. Pesannya sengaja dibuat generik; sertakan `request_id` saat melaporkannya. | Ulangi sekali setelah beberapa detik; laporkan beserta ID permintaan jika masih terjadi. |
| UPSTREAM_FAILED | 503 | Sumber data di balik endpoint ini tidak menjawab tepat waktu. Tidak ada angka usang atau angka pengganti yang dikembalikan sebagai gantinya. | Ulangi dengan backoff; periksa halaman status. |
| UNAVAILABLE | 501 / 503 | Dataset untuk sementara belum siap (cache sedang diisi) atau endpoint belum memiliki sumber publik yang sah. | Ulangi nanti; katalog menandai endpoint yang memang tidak tersedia secara desain. |
| REQUEST_FAILED | 200 | Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP. | Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal. |
Coba
/api/coin-existsTersediastring — Coin symbol; empty returns exists:false.
https://www.coinboss.com/api/coin-exists?coin=BTCLainnya di kategori ini
- Matriks kualitas data (tampilan kolektor) /api/sd/quality
- Katalog API /api/meta/catalog
- Catatan perubahan dan kebijakan versi /api/meta/changelog
- Dokumentasi endpoint /api/meta/endpoint
- Dokumen OpenAPI /api/meta/openapi
- Matriks kualitas data /api/meta/quality
- Status layanan /api/meta/status
- Memeriksa apakah suatu simbol koin dikenal oleh platform /api/coin-exists
- Peta simbol koin ke path ikon yang di-host secara lokal /api/coin-icons
- Ringkasan agregat halaman koin /api/content/coin
- Ringkasan bagian seluruh situs /api/content/summary
- Tabel kurs valas fiat /api/currency/fx
- Peta id bursa ke path ikon yang di-host secara lokal /api/exchange-icons
- Pemeriksaan liveness /api/health
- Statistik halaman riset /api/research/stats