Setiap sumber, terlihat

Penerusan, per sumber

Sebagian besar API logam mengumpulkan harga dari beberapa umpan data, menghitung median tertimbang, membuang data masukannya, lalu memberikan satu angka kepada Anda. Penggabungannya tidak transparan. Ketika harga berbeda antar bursa (yang terjadi setiap hari saat pergantian kontrak, penyelesaian, dan setiap penutupan pasar), Anda tidak dapat mengetahui apakah angka dari API mencerminkan kenyataan atau pembobotan internal API.

Harga spot diteruskan dari satu sumber utama berlisensi tanpa penggabungan atau perataan. Saat terjadi gangguan, sumber cadangan berlisensi menyediakan harga emas dan perak. Tembaga tidak memiliki sumber cadangan. Tambahkan ?include=sources untuk melihat sumber yang menghasilkan harga tersebut, harganya, fetched_at, dan source_timestamp.

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

Sumber data yang kami terima

Kategori sumber pada setiap tingkat. Bukti per panggilan tentang umpan data yang digunakan untuk suatu harga terdapat dalam respons /v1/prices Anda.

Pengenal sumber, frekuensi pembaruan, dan detail endpoint penyedia didokumentasikan secara internal dan berkembang pada setiap rilis. Jika Anda memerlukan detail ini untuk evaluasi hukum, kirim email ke hello@goldprice.dev dengan kasus penggunaan Anda dan kami akan merespons.

Harga selain USD pada halaman mata uang adalah harga spot emas USD dikalikan kurs langsung dari exchangerate.dev, API mata uang saudara kami. Baris spot selain USD tidak menggunakan kurs tersimpan sebagai cadangan. Jika kurs langsung berhenti, /v1/convert dan /v1/carat menggunakan kurs tersimpan terbaru yang berusia hingga 3 hari; baris spot selain USD mempertahankan harga kedaluwarsa.

Umpan harga spot cadangan

Harga spot menggunakan data pasar utama berlisensi. Harga bid/ask hanya tersedia pada paket berbayar dan bersifat opsional, serta memerlukan kuotasi dua sisi yang konsisten. Jika sumber utama berhenti, emas dan perak beralih ke sumber cadangan berlisensi sampai sumber utama kembali. Harga cadangan dapat tertinggal hingga sekitar dua menit dari pasar. Selama sumber cadangan digunakan, respons tidak memiliki bid atau ask.

Kami tidak menggunakan sumber cadangan saat pasar logam tutup: setiap hari dari 17:00 hingga 18:00 dan dari Jumat 17:00 hingga Minggu 18:00, semuanya dalam waktu New York. Tembaga tidak memiliki sumber cadangan. Jika umpan datanya berhenti, harga tembaga terakhir ditandai sebagai kedaluwarsa.

Divergensi antar sumber

Baris dengan setidaknya dua sumber utama yang masih mutakhir menyertakan divergence_bps: selisihnya dalam basis poin relatif terhadap rata-rata. Baris spot menggunakan satu sumber dan tidak menyertakannya. GET /v1/prices/divergence mencantumkan simbol yang melampaui ambang selisih pada setiap tingkat.

divergence_flag tetap false pada XAU-USD-SPOT; emas selain USD menggunakan spot USD × kurs langsung exchangerate.dev.

Tentang penetapan harga LBMA

Kedaluwarsa, per sumber

is_stale pada tingkat teratas menjadi true ketika sumber yang menyediakan harga melewati jendela pembaruan yang diharapkan. Tambahkan ?include=sources untuk melihat harga sumber tersebut, fetched_at, dan source_timestamp, lalu nilai sendiri kemutakhirannya.

Pandangan ke depan: kurva kontrak berjangka

Jalur harga ke depan yang tersirat dari pasar disediakan oleh /v1/forward-view/{asset}. Penjelasan berikut mencakup perhitungan, sumber, dan frekuensi pembaruan.

Kurva kontrak berjangka

5 kontrak berjangka emas berikutnya. Harga penyelesaian tertunda ~15 menit melalui seri umpan data tertunda utama kami dengan cadangan sekunder. Nilai kontrak berjangka berasal dari umpan data tertunda yang tersedia untuk publik dan bukan data waktu nyata berlisensi. Garis putus-putus menghubungkan 5 titik penyelesaian; celah muncul ketika umpan data utama dan cadangan sama-sama gagal untuk suatu kontrak. Open interest dan volume ditangani sebisanya, bernilai null, dan tidak ditampilkan dalam respons.

Kemutakhiran data

Pembaruan harga penyelesaian kontrak berjangka dijalankan pada hari kerja pukul 20:30 UTC: satu jadwal sepanjang tahun, +2h setelah penyelesaian dalam EDT, +1h dalam EST, tetap saat pergantian waktu musim panas.

Yang tidak kami lakukan

• Penetapan harga LBMA Lihat di atas.
• Buku pesanan L2 tingkat tick Kami menerbitkan harga, bukan kedalaman pasar. Buku pesanan tingkat tick berada di luar cakupan API ini.
• Jaminan latensi di bawah satu detik Kami tidak menerbitkan SLA latensi numerik.
• Penggabungan diam-diam Inti dari halaman ini.

Tanya jawab

Asal harga kami dan cara kerja cakupan cadangan.

Siapa penyedia data utama dan cadangan Anda?

Kami menggunakan satu penyedia data pasar utama berlisensi untuk emas, perak, dan tembaga. Penyedia cadangan berlisensi mencakup emas dan perak. Kami tidak menyebutkan nama kedua penyedia tersebut.

Apakah harga spot Anda merupakan harga gabungan atau kuotasi dari satu kontributor?

Kami meneruskan harga penyedia utama tanpa penggabungan atau perataan. Harga tersebut bukan tolok ukur resmi atau penetapan harga LBMA. ?include=sources mengembalikan sources[] dengan fetched_at dan source_timestamp.

Apa yang terjadi jika umpan data utama Anda berhenti?

Sumber cadangan berlisensi menyediakan harga emas dan perak saat sumber utama tidak tersedia. Sumber ini dapat tertinggal sekitar dua menit dan tidak memiliki bid atau ask. Tembaga tidak memiliki sumber cadangan. is_stale menjadi true ketika sumber yang digunakan melewati jendela pembaruan yang diharapkan.

Catatan perubahan metodologi

Untuk rilis endpoint API, tingkat, dan produk di luar revisi metodologi, lihat catatan perubahan produk.

Ada pertanyaan tentang API? Baca dokumentasi.