Menu

Mulai cepat

Dapatkan harga XAU/USD langsung dalam beberapa menit.

Sebelum memulai

Anda memerlukan curl atau klien HTTP apa pun, dan kunci API gratis. Daftar, konfirmasi email, lalu salin kunci dari akun Anda. Paket gratis mencakup 100 permintaan per jam.

Dapatkan kunci gratis

Permintaan pertama

Kirim kunci Anda di header X-API-Key. Simpan di server Anda, bukan di kode yang bisa dilihat pengunjung.

curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"

Membaca respons

price adalah harga per satuan dalam jawaban: troy ounce, atau pound untuk tembaga. gram adalah harga satu gram pada karat dalam jawaban, dan updatedAt adalah waktu jawaban dibuat.

Respons 200

{
    "symbol": "XAU",
    "name": "Gold",
    "currency": "USD",
    "unit": "oz",
    "price": 4072.1,
    "gram": 130.921,
    "karat": 24,
    "updatedAt": "2026-11-07T02:44:05+02:00"
}

Saat terjadi kesalahan

Kesalahan berupa JSON dengan kolom error. Yang umum adalah 401 api_key_required jika header tidak ada, 401 invalid_api_key jika kunci salah, dan 403 email_not_verified sampai email dikonfirmasi. Melewati batas menghasilkan 429 rate_limit_exceeded dengan header Retry-After.

Langkah berikutnya