
Jika aplikasi membutuhkan harga emas per gram, ambil langsung daftar kemurnian dari endpoint publik `/v1/carat`. Satu permintaan mengembalikan nilai 24K, 22K, 21K, 20K, 18K, 16K, 14K, dan 10K dalam mata uang pilihan. Anda bisa mencobanya tanpa API key.
Mengambil harga emas per gram dengan Python
Contoh ini hanya memakai pustaka standar Python dan membaca harga sebagai Decimal agar perhitungan uang tidak terkena selisih floating point.
import jsonfrom decimal import Decimalfrom urllib.parse import urlencodefrom urllib.request import Request, urlopenurl = "https://api.goldprice.dev/v1/carat?" + urlencode({"currency": "IDR"})with urlopen(Request(url, headers={"Accept": "application/json"}), timeout=10) as response: payload = json.load(response)prices = { "currency": payload["currency"], "timestamp": payload["timestamp"], "24k": Decimal(payload["price_gram_24k"]), "22k": Decimal(payload["price_gram_22k"]), "18k": Decimal(payload["price_gram_18k"]),}Ganti IDR dengan USD, EUR, GBP, INR, AED, JPY, atau mata uang lain yang didukung. Simpan juga timestamp karena field itu menunjukkan waktu observasi harga.
Menghitung nilai barang emas
Untuk barang 18K seberat 12,5 gram, kalikan harga 18K per gram dengan beratnya, lalu bulatkan hasil akhir satu kali.
from decimal import Decimal, ROUND_HALF_UPweight = Decimal("12.5")value = (weight * prices["18k"]).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)Endpoint sudah menyajikan nilai per gram sesuai presisi unit minor mata uang yang diminta. Hasilnya adalah nilai indikatif kandungan emas, bukan otomatis harga toko atau harga buyback. Ongkos pembuatan, batu, pajak, premi dealer, biaya pemurnian, dan potongan buyback dihitung terpisah.
Cara API menghitung gram dan karat
API mengonversi XAU ke mata uang pilihan, membagi harga per troy ounce dengan 31.1034768, lalu mengalikan fraksi kemurnian seperti 22 / 24 atau 18 / 24.
Checklist produksi
- Pertahankan nilai sebagai
Decimal. - Simpan
timestampbersama harga. - Cache respons berhasil sesuai kebutuhan kesegaran.
- Jangan ganti kegagalan dengan nol atau timestamp baru.
- Tandai hasil sebagai indikatif, bukan harga penyelesaian.
- Simpan API key akun hanya di server.
Lihat kontrak endpoint lengkap atau gunakan API historis untuk OHLC harian.
Harga emas real-time, OHLC historis, dan agregasi multi-sumber, tersedia via REST dan SSE.