Harga Emas per Gram dengan Python (24K, 22K, 18K)
Ambil harga emas per gram untuk 24K, 22K, dan 18K dengan Python tanpa API key, lalu hitung nilainya secara aman memakai Decimal.
Baca →Impor template portofolio emas ke Google Sheets, perbarui satu harga acuan, lalu hitung nilai indikatif, biaya, dan perubahan untuk setiap kepemilikan.
Jika Anda memiliki batangan, koin, atau perhiasan emas, satu angka total sulit diperiksa. Template ini memberi setiap kepemilikan satu baris, memisahkan biaya pembelian dari nilai spot saat ini, dan menampilkan waktu harga yang digunakan. Hasilnya adalah valuasi indikatif, bukan appraisal atau janji harga jual dari dealer.
Unduh pelacak portofolio emas. Di Google Drive, pilih New → File upload, buka file .xlsx, lalu pilih File → Save as Google Sheets. Bantuan Google menjelaskan cara membuka dan mengunduh file spreadsheet: https://support.google.com/docs/answer/49114.
Workbook ini memiliki tiga sheet:
Nama sheet dan kolom tetap dalam bahasa Inggris agar sesuai dengan workbook dan formula.
Di Portfolio, ganti tiga baris contoh dengan data Anda. Satu baris dapat mewakili satu barang atau beberapa barang yang identik.
| Kolom | Yang dimasukkan |
|---|---|
| Holding | Label seperti batangan 1 oz atau cincin 18K |
| Unit | grams atau troy oz |
| Quantity | Jumlah yang diukur |
| Purity | 99.9% untuk batangan murni, 75% untuk 18K, atau kemurnian terdokumentasi lainnya |
| Purchase cost | Total biaya dalam mata uang yang sama dengan Price Data |
| Purchase date | Tanggal pembelian atau pencatatan |
| Notes | Catatan opsional tentang dealer, kuitansi, atau identitas |
Gunakan satu mata uang untuk semua biaya. Template mengubah troy ounce memakai 31.1034768 gram dan tetap menampilkan jumlah asli agar konversinya mudah diperiksa.
Endpoint yang digunakan template:
GET https://api.goldprice.dev/v1/carat?currency=USD
Respons berisi price_gram_24k, timestamp, dan currency. Salin harga 24K numerik ke Price Data → B6, timestamp respons ke B5, dan mata uang kuotasi ke B7. Perbarui ketiganya bersama-sama. Ubah B3 hanya jika memiliki kuotasi baru untuk mata uang tersebut, dan gunakan mata uang yang sama untuk biaya pembelian. Jangan mengubah kuotasi USD lama menjadi IDR hanya dengan mengganti B3. Field harga API berbentuk string desimal dalam JSON; masukkan nilainya sebagai angka di spreadsheet agar formula dapat menghitung.
File unduhan berisi data contoh yang diberi tanda agar formula langsung menampilkan hasil setelah diimpor. Ganti harga contoh sebelum memakai hasilnya. Workbook tidak mengambil data otomatis dan tidak menyimpan API key. Jika workbook bersama memerlukan autentikasi, gunakan proxy server; jangan menaruh kredensial di spreadsheet atau bound script yang dapat diperiksa editor lain.
Untuk menambahkan menu refresh, unduh Apps Script pendamping, buka workbook di Google Sheets, pilih Extensions → Apps Script, hapus kode awal, lalu tempel isi file. Simpan dan muat ulang spreadsheet. Menu Gold portfolio → Refresh price data membuat satu request tanpa API key memakai mata uang di Price Data → B3. Script memeriksa status HTTP, mata uang respons, price_gram_24k yang positif dan finite, serta timestamp sebelum menulis B5:B7 sekaligus. Jika gagal, harga, timestamp, dan mata uang kuotasi sebelumnya tetap dipertahankan. Jika menempel manual, perbarui B5, B6, dan B7 dari respons yang sama. Script tidak membuat timer dan tidak melakukan polling di latar belakang.
Setiap baris memakai empat langkah sederhana:
Weight (g) mengubah jumlah menjadi gram.Spot price/g mengambil harga 24K dari Price Data.Indicative value menghitung Weight (g) × Purity × Spot price/g.Change menghitung Indicative value − Purchase cost.Contoh: 10 gram dengan kemurnian 75% dan harga 24K 128.24 per gram menghasilkan 10 × 0.75 × 128.24 = 961.80 dalam mata uang harga. Ini adalah nilai kandungan emas pada harga spot acuan. Biaya pembuatan, batu, pajak, premi lokal, spread dealer, dan diskon buyback tidak termasuk.
Ringkasan menghitung jumlah baris yang memiliki kuantitas, total berat setelah konversi, total biaya, total nilai indikatif, dan perubahan. Baris kosong tetap kosong pada kolom perhitungan.
Harga spot berubah. Price timestamp (UTC) menunjukkan respons yang dipakai formula. Saat memperbarui harga, perbarui timestamp pada waktu yang sama. Jika workbook dipakai sebagai laporan, simpan respons sumber atau catat timestamp agar perhitungan dapat diulang.
0.999 sebagai teks, bukan 99.9% sebagai persentase.Change sebagai keuntungan pasti; angka itu hanya membandingkan nilai spot dan tidak mengurangi biaya penjualan.Template ini membantu menata kepemilikan dan memeriksa aritmetika nilai berbasis spot. Template ini bukan appraisal, catatan akuntansi, laporan pajak, rekomendasi investasi, atau harga jual yang dijamin. Penawaran dealer dapat berbeda karena spread, premi, biaya pemurnian, pajak, kondisi, dan syarat transaksi. Periksa aturan setempat dan penawaran nyata sebelum mengambil keputusan finansial.
Untuk mengambil harga emas live dan historis di spreadsheet, lihat tutorial Gold Price API untuk Google Sheets.
panduan terkait
Ambil harga emas per gram untuk 24K, 22K, dan 18K dengan Python tanpa API key, lalu hitung nilainya secara aman memakai Decimal.
Baca →Gabungkan bar harian XAU/USD yang telah settle dengan observasi FX historis untuk menguji strategi emas dalam mata uang lokal tanpa secara tidak sengaja menggunakan kurs yang belum tersedia pada saat itu.
Baca →Tambahkan widget harga emas live gratis dan bisa dikonfigurasi ke WordPress dengan satu iframe. Berfungsi di Gutenberg dan Elementor, tanpa API key, tanpa plugin.
Baca →goldprice.dev
Harga emas real-time, OHLC historis, dan agregasi multi-sumber — tersedia via REST dan SSE.