goldprice.devDapatkan peringatan harga emas dari akun Anda dengan paket Plus atau Pro. Pada Free atau Basic, jadwalkan pemeriksaan API dan hubungkan alat notifikasi Anda sendiri. Harga saat ini adalah US$3.906,56 per troy ounce per 2 Nov 2026, 05.29 UTC. Harga pada Free tertunda lima belas menit.
- Plus dan Pro masing-masing mencakup lima peringatan harga bawaan.
- Peringatan bawaan memeriksa harga langsung dan mengirim permintaan POST bertanda tangan ke URL Anda.
- Untuk Free dan Basic, jadwalkan pemeriksaan dan simpan status terakhir.
Buat peringatan bawaan
Plus dan Pro masing-masing mencakup lima peringatan harga. Free dan Basic tidak menyediakannya. Bandingkan harga paket, lalu masuk dan buka peringatan akun untuk membuatnya. Setiap peringatan memantau satu logam: emas, perak atau tembaga.
Pilih satu aturan: harga melewati ambang ke atas, ke bawah atau kedua arah; perubahan persentase selama satu jam atau dua puluh empat jam; atau penutupan harian. Peringatan memeriksa harga langsung. Setiap peringatan mengirim paling banyak satu pemberitahuan ambang atau persentase per jam, atau satu pemberitahuan penutupan harian per hari UTC.
Jadwalkan pemeriksaan pada Free atau Basic
Untuk Free dan Basic, jalankan permintaan di bawah setiap lima belas menit. Permintaan ini membaca harga emas per troy ounce dari /v1/spot/XAU-USD-SPOT. Pilih ambang dengan mata uang dan satuan yang sama. Permintaan tanpa kunci tidak memerlukan kunci atau pendaftaran, jadi Anda dapat memulainya tanpa akun.
Jadwal tersebut menghasilkan empat permintaan per jam, sembilan puluh enam per hari dan sekitar dua ribu sembilan ratus per bulan. Jumlah ini sesuai batas tanpa kunci: sepuluh permintaan per menit dan seratus per jam per IP, serta kuota kunci gratis sebesar lima ribu panggilan per bulan.
curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"Periksa pengiriman dan tanda tangan
Peringatan bawaan mengirim permintaan POST bertanda tangan dengan isi JSON ke URL pilihan Anda. Gunakan https pada port 443 dengan nama host publik. Alamat privat atau lokal ditolak. Isinya mencakup event, alert_id, kind, symbol, direction, price dan observed_at. Kolom aturan berupa level; percent, window dan reference_price; atau date dan close.
Header Webhook-Signature ditulis sebagai t=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>. Simpan rahasia penandatanganan saat membuat peringatan karena hanya ditampilkan sekali. Verifikasi tanda tangan terhadap isi permintaan yang diterima dan tolak tanda tangan yang berusia lebih dari lima menit.
Kirim pengiriman uji dari halaman peringatan untuk memeriksa URL penerima Anda. goldprice.dev tidak mengirim email atau SMS. Permintaan POST dikirim ke URL yang Anda kelola, seperti webhook masuk pada alat percakapan atau server kecil.
Simpan status untuk pemeriksaan terjadwal
Untuk pemeriksaan terjadwal, baca is_stale dan computed_at sebelum membandingkan harga. Harga pada Free tertunda lima belas menit. Gunakan pembacaan valid pertama untuk menentukan apakah harga berada di atas atau di bawah ambang Anda, lalu simpan status tersebut.
Kirim notifikasi saat pembacaan valid berikutnya melewati ambang Anda. Untuk pergerakan naik, status berubah dari di bawah menjadi tepat pada atau di atas ambang. Balik perbandingannya untuk pergerakan turun. Pembacaan berulang di sisi yang sama tidak boleh mengirim peringatan berulang. Pemeriksaan berkala bisa melewatkan harga yang melintasi ambang lalu kembali di antara pemeriksaan.
Ikuti tutorial penyiapan
Tutorial peringatan harga menunjukkan skrip yang memeriksa harga, menyimpan status terakhir dan mengirim ke webhook masuk layanan percakapan. Ikuti tutorial ini untuk membuat alur dari permintaan terjadwal hingga notifikasi yang berfungsi.
Untuk penyiapan tanpa menulis skrip, ikuti tutorial alur kerja terjadwal atau . Apa pun cara yang Anda gunakan, tetap periksa kebaruan data, kesesuaian satuan dan status tersimpan. Notifikasi dikirim melalui alat pilihan Anda.