goldprice.devgoldprice.dev menyediakan REST API untuk harga emas, perak, dan tembaga. Gunakan /v1/carat untuk harga emas per gram menurut karat dalam IDR, atau /v1/prices untuk harga spot. Paket Free mencakup 5.000 permintaan per bulan. Semua permintaan di bawah bisa dicoba tanpa kunci.
Data yang dikembalikan API
Setiap endpoint mengembalikan JSON melalui HTTPS. Tabel berikut menunjukkan data yang tersedia beserta paket minimum untuk mengaksesnya.
| Endpoint | Data respons | Paket minimum |
|---|---|---|
/v1/prices | Harga spot emas, perak, dan tembaga | Free |
/v1/carat | Harga emas per gram menurut karat dalam IDR | Free |
/v1/convert | Konversi antara logam, mata uang, dan satuan | Free |
/v1/bars | Riwayat OHLC harian (Free: 30 hari terakhir) | Free |
/v1/physical | Harga emas dan perak dari penjual menurut negara | Basic |
Kirim permintaan pertama
Permintaan ini mengambil harga emas menurut karat dalam IDR. Kirim kunci melalui header Authorization: Bearer. Tanpa kunci, permintaan yang sama bisa dijalankan selama masih dalam batas tanpa kunci.
curl "https://api.goldprice.dev/v1/carat?currency=IDR" \ -H "Authorization: Bearer $GOLDPRICE_API_KEY"const res = await fetch("https://api.goldprice.dev/v1/carat?currency=IDR", { headers: { Authorization: `Bearer ${process.env.GOLDPRICE_API_KEY}` },})const data = await res.json()if (!res.ok) throw new Error(data.error)import os, requestsres = requests.get( "https://api.goldprice.dev/v1/carat?currency=IDR", headers={"Authorization": f"Bearer {os.environ['GOLDPRICE_API_KEY']}"}, timeout=10,)res.raise_for_status()data = res.json()Memahami respons
Setiap kolom dari price_gram_24k hingga price_gram_10k berisi harga emas per gram untuk karat tersebut dalam IDR. Nilainya berupa string agar presisi tetap terjaga. timestamp menunjukkan waktu harga spot dalam UTC. Contoh ini diambil pada 19 Oktober 2026, bukan harga saat ini.
{ "currency": "IDR", "timestamp": "2026-10-19T13:51:03.044551Z", "price_gram_24k": "2408499.26", "price_gram_22k": "2207790.99", "price_gram_21k": "2107436.85", "price_gram_20k": "2007082.71", "price_gram_18k": "1806374.44", "price_gram_16k": "1605666.17", "price_gram_14k": "1404957.90", "price_gram_10k": "1003541.36"}Bandingkan paket
Semua paket mencakup harga spot, harga per karat, dan konversi. Paket berbayar menambahkan harga langsung, riwayat lebih panjang, harga penjual, dan streaming sesuai paket. Detail di paket harga.
| Paket | Free | Basic | Plus | Pro |
|---|---|---|---|---|
| Harga bulanan (dolar AS) | $0 | $19 | $39 | $89 |
| Permintaan per bulan | 5.000 | 100.000 | 300.000 | 1.000.000 |
| Permintaan per menit | 10 | 60 | 120 | 300 |
| Harga spot | Terlambat 15 menit | Langsung | Langsung | Langsung |
| Riwayat harian | 30 hari | 1 tahun | Lengkap, emas sejak 1996 | Lengkap, emas sejak 1996 |
| Harga penjual menurut negara | Tidak | Ya | Ya | Ya |
| Streaming | Tidak | Tidak | Ya | Ya |
| Server MCP | Ya | Ya | Ya | Ya |
| Penggunaan komersial | Boleh, dengan tautan ke goldprice.dev | Ya | Ya | Ya |
Coba tanpa kunci
/v1/prices, /v1/spot/{symbol}, /v1/carat, dan /v1/convert bisa diakses tanpa kunci: 10 permintaan per menit dan 100 per jam untuk setiap alamat IP, dengan data paket Free. Jika batas terlampaui, API mengembalikan 429 dengan isi respons JSON yang menyebutkan batas tersebut.
Langkah berikutnya
Baca dokumentasi untuk setiap endpoint dan parameter, lalu dapatkan kunci gratis untuk menggunakan kuota sendiri.