GET /v1/gold/history

Returns newest gold records first. Each record contains all supported karats.

Bearer key required JSON response

Parameters

ParameterTypeDescription
from optional date

Inclusive start date in YYYY-MM-DD format. Defaults to 30 days before the request.

to optional date

Inclusive end date in YYYY-MM-DD format. Defaults to the current date.

limit optional integer

Page size from 1 to 1,000 records.

Default: 250
cursor optional string

Opaque continuation cursor returned as meta.nextCursor.

One request can cover at most 366 days.

Pagination

Pass the non-null meta.nextCursor value back unchanged with the same date filters. A null cursor means the result is complete.

Example request

curlGold history
curl "https://api.exchangedz.com/v1/gold/history?from=2026-07-01&to=2026-08-24&limit=250" \
  -H "Authorization: Bearer $EXDZ_API_KEY"

Response

json200 OK
{
  "data": [
    {
      "date": "2026-08-24",
      "quote": "DZD",
      "unit": "gram",
      "prices": { "18k": 26422.50, "21k": 30826.25, "24k": 35230 },
      "source": "yahoo-finance-gc-f",
      "updatedAt": "2026-08-24T07:02:18.000Z"
    }
  ],
  "meta": {
	    "requestId": "req_01J6EXDZ...",
	    "count": 1,
	    "quote": "DZD",
	    "unit": "gram",
	    "from": "2026-07-01T00:00:00.000Z",
	    "to": "2026-08-24T23:59:59.999Z",
	    "limit": 250,
	    "nextCursor": null
  }
}