Commodity
XAUUSD market data API
Gold/USD. Query the latest XAUUSD price, recent candles and history over REST, or stream it over WebSocket.
Symbol details
- symbolCode
- XAUUSD
- Name
- Gold/USD
- Market class
- Commodity
Pass XAUUSD as symbolCode on every endpoint below. GET /api/v1/symbol lists every supported symbol, and GET /api/v1/me returns the exact symbols and timeframes your API key can use.
Plans and timeframes
Which plans include XAUUSD, and the timeframes, history window and WebSocket access each plan has.
| Plan | Includes XAUUSD | Timeframes | Historical data | WebSocket |
|---|---|---|---|---|
| Free | Yes | M1, M5, H1 | — | — |
| Starter | Yes | M1, M5, M15, H1, H4, D1 | 30 days | — |
| Plus | Yes | M1, M5, M15, H1, H4, D1 | 3 months | ✓ |
| Pro | Yes | M1, M5, M15, H1, H4, D1 | 1 year | ✓ |
| Business | Yes | M1, M5, M15, H1, H4, D1 | Up to 10 years | ✓ |
| Enterprise | Custom | Custom | Custom | ✓ |
See pricing for request limits and prices.
Latest XAUUSD price
GET /api/v1/price returns the latest XAUUSD candle for one timeframe.
curl "https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1"const params = new URLSearchParams({
apiKey: process.env.REALMARKETAPI_KEY,
symbolCode: "XAUUSD",
timeFrame: "H1",
})
const res = await fetch(`https://api.realmarketapi.com/api/v1/price?${params}`)
if (!res.ok) throw new Error(`HTTP ${res.status}`)
console.log(await res.json())import os
import requests
res = requests.get("https://api.realmarketapi.com/api/v1/price", params={
"apiKey": os.environ["REALMARKETAPI_KEY"],
"symbolCode": "XAUUSD",
"timeFrame": "H1",
})
res.raise_for_status()
print(res.json())XAUUSD candles and history
GET /api/v1/candle returns the most recent XAUUSD candles for one timeframe.
curl "https://api.realmarketapi.com/api/v1/candle?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1"GET /api/v1/history pages through stored candles between startTime and endTime. Needs a plan with historical data.
curl "https://api.realmarketapi.com/api/v1/history?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&startTime=2026-11-10T00:00:00Z&endTime=2026-11-11T00:00:00Z&pageNumber=1&pageSize=100"Stream XAUUSD over WebSocket
WebSocket streams need a plan with WebSocket access (see the table above).
// /price streams XAUUSD H1 candles; use /candles for the rolling window.
const ws = new WebSocket("wss://api.realmarketapi.com/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1")
ws.onmessage = (event) => console.log(JSON.parse(event.data))
ws.onclose = (event) => console.log("closed", event.code, event.reason)import asyncio, json, websockets
async def main():
url = "wss://api.realmarketapi.com/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1"
async with websockets.connect(url) as ws:
async for message in ws:
print(json.loads(message))
asyncio.run(main())Start querying XAUUSD
Create a free API key and try these requests in the playground.