Free XAUUSD Historical Data API

XAUUSD coverage and timeframes

The API serves gold datasets for XAUUSD and XAUAUD. XAUUSD is the primary feed, with intraday and higher-timeframe history suitable for gold scalping tests, swing models and multi-timeframe filters.

The XAUUSD M15 dataset contains 225,077 bars from 2017-01-19 to 2026-10-30. Other timeframes have different start dates and row counts. Use the data builder to inspect exact coverage before downloading a large file.

Request XAUUSD OHLC data

The OHLC endpoint accepts a symbol, timeframe, date range and optional format. The date range is inclusive and limited to 366 days per request. JSON is the default; add format=csv for a spreadsheet-friendly response.

XAUUSD is quoted with three decimals on the Exness-style source feed. The API returns the stored prices without rewriting them for another broker's digits.

Gold data quality

The XAUUSD M15 report scores 97.0 / 100 and receives an A grade. The audit checks duplicate timestamps, OHLC violations, non-positive prices, flat bars, zero volume, zero spread, extreme returns, gaps and weekend bars.

• No duplicate timestamps or OHLC violations in the M15 audit.
• Small numbers of flat bars and zero-spread bars are reported as warnings, not hidden.
• Expected market-closure gaps remain visible so you can decide how to handle weekends and holidays.

Open the full XAUUSD M15 quality report or query the Data Quality API before using a dataset in production.

Common XAUUSD API use cases

Limits, timezone and best practice

Anonymous access is limited to 60 requests per minute and 1,000 requests per day per IP. A single request can return up to 50,000 rows and cover at most 366 days. For a multi-year M1 study, split the date range into smaller windows and cache each response.

Timestamps are broker server time, not UTC. Convert them explicitly if your model uses New York or London session boundaries. When a request is too large, the API returns 413 with a clear error instead of silently truncating the dataset.

Request examples

curl "https://www.algospecial.com/api/ohlc.php?symbol=XAUUSD&tf=M15&from=2026-01-01&to=2026-01-31&format=json"

import pandas as pd
import requests

url = "https://www.algospecial.com/api/ohlc.php"
params = {
    "symbol": "XAUUSD",
    "tf": "M15",
    "from": "2026-01-01",
    "to": "2026-01-31",
}
response = requests.get(url, params=params, timeout=30)
response.raise_for_status()
df = pd.DataFrame(response.json()["data"])
df["Timestamp"] = pd.to_datetime(df["Timestamp"])
print(df.head())

curl "https://www.algospecial.com/api/ohlc.php?symbol=XAUUSD&tf=H1&from=2026-01-01&to=2026-03-31&format=csv" -o XAUUSD_H1.csv

All timestamps are broker server time. Some legacy forex exports return 0 for TickVolume and Spread because those fields were not present in the source feed.

Related API guides