CSV and JSON OHLC API Formats

JSON response shape

JSON is the default. The top-level object contains request metadata and a data array. Each array item is one OHLC bar.

CSV response

Add format=csv to receive a header row followed by one row per bar. The CSV header is:

Timestamp,Open,High,Low,Close,TickVolume,Spread

The timestamp uses YYYY.MM.DD HH:MM:SS in broker server time. Prices are numeric. TickVolume and Spread are integers and may be 0 on legacy forex feeds.

Which format should you use?

Format notes and limitations

• JSON and CSV contain the same rows; the format does not change the data.
• Timestamps are broker server time, not UTC.
• Some legacy datasets have no tick volume or spread; those fields return 0.
• The HTTP API does not return Parquet. Parquet is available through the download builder.
• A response is capped at 50,000 rows and a 366-day range.

Request examples

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

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

import pandas as pd

url = "https://www.algospecial.com/api/ohlc.php"
params = {
    "symbol": "XAUUSD",
    "tf": "M15",
    "from": "2026-01-01",
    "to": "2026-01-31",
    "format": "csv",
}
df = pd.read_csv(url, params=params)
df["Timestamp"] = pd.to_datetime(df["Timestamp"])
print(df.head())

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