Karat API

Dokumentasi API

Akses harga emas terbaru, riwayat harga, dan daftar penyedia melalui REST API Karat.

Memulai

Akses data harga emas terbaru dan historis dari berbagai penyedia melalui API Karat. Seluruh timestamp API menggunakan ISO 8601 UTC, sementara filter tanggal dapat disesuaikan dengan zona waktu melalui header X-Timezone

Base URL

https://www.karat.web.id/api/v1

Authentication

Authorization: Bearer YOUR_API_KEY

Status	Arti
200	Request berhasil.
401	API key tidak ada atau tidak valid.
403	API key tidak memiliki akses.
422	Parameter tidak valid.
429	Rate limit terlampaui.

GET /gold/latest

Harga emas terbaru

Mengambil snapshot harga emas terbaru.

Parameter	Lokasi	Keterangan
provider	Query	Opsional. Filter slug provider.
source	Query	Opsional. Filter slug sumber.

Contoh request

curl --request GET \
  --url 'https://www.karat.web.id/api/v1/gold/latest?provider=antam' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Contoh response

{
  "success": true,
  "message": "Gold price retrieved successfully",
  "data": {
    "provider": "antam",
    "source": "logammulia",
    "currency": "IDR",
    "unit": "gram",
    "sell": {
      "price": 2574000,
      "difference": 10000,
      "source_updated_at": "2026-10-05T01:30:00.000000Z"
    },
    "buyback": {
      "price": 2380000,
      "difference": -5000,
      "source_updated_at": "2026-10-05T01:30:00.000000Z"
    },
    "collected_at": "2026-10-05T01:35:00.000000Z"
  }
}

GET /gold/history

Riwayat harga emas

Mengambil riwayat harga dengan filter tanggal dan pagination.

Parameter	Format	Keterangan
provider	string	Opsional. Filter slug provider.
source	string	Opsional. Filter slug sumber.
date_from	YYYY-MM-DD	Opsional. Tanggal awal.
date_to	YYYY-MM-DD	Opsional. Tanggal akhir, harus setelah date_from.
per_page	1–100	Opsional. Jumlah data per halaman. Default 15.
page	integer	Opsional. Nomor halaman. Default 1.
X-Timezone	IANA timezone	Header opsional. Menentukan batas hari filter tanggal. Default UTC.

Contoh request

curl --request GET \
  --url 'https://www.karat.web.id/api/v1/gold/history?provider=antam&date_from=2026-10-01&date_to=2026-10-05' \
  --header 'Accept: application/json' \
  --header 'X-Timezone: Asia/Jakarta' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Contoh response

{
  "success": true,
  "message": "Gold price history retrieved successfully",
  "data": {
    "items": [
      {
        "provider": "antam",
        "source": "logammulia",
        "currency": "IDR",
        "unit": "gram",
        "sell": {
          "price": 2574000,
          "difference": 10000,
          "source_updated_at": "2026-10-05T01:30:00.000000Z"
        },
        "buyback": {
          "price": 2380000,
          "difference": -5000,
          "source_updated_at": "2026-10-05T01:30:00.000000Z"
        },
        "collected_at": "2026-10-05T01:35:00.000000Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "last_page": 1,
      "per_page": 15,
      "total": 1,
      "next_page_url": null,
      "previous_page_url": null
    }
  }
}

GET /providers

Daftar penyedia

Mengambil provider dan sumber aktif yang tersedia.

Contoh request

curl --request GET \
  --url 'https://www.karat.web.id/api/v1/providers' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Contoh response

{
  "success": true,
  "message": "Providers retrieved successfully",
  "data": [
    {
      "name": "ANTAM",
      "slug": "antam",
      "sources": [
        {
          "name": "Logam Mulia",
          "slug": "logammulia"
        }
      ]
    }
  ]
}