Tài liệu tham khảo RealMarketAPI

GEThttps://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1

{
  "SymbolCode": "XAUUSD",
  "OpenPrice": 5168.43,
  "ClosePrice": 5174.00,
  "HighPrice": 5176.85,
  "LowPrice": 5165.20,
  "Bid": 5173.75,
  "Ask": 5174.25,
  "Volume": 1249.33,
  "OpenTime": "2026-03-08T09:20:00Z"
}

GEThttps://api.realmarketapi.com/api/v1/history?apiKey=YOUR_API_KEY&symbolCode=ETHUSD&timeFrame=H1&startTime=2026-02-08T00:00:00Z&endTime=2026-03-08T00:00:00Z&pageNumber=1&pageSize=10

{
  "Data": [
    {
      "SymbolCode": "ETHUSD",
      "OpenPrice": 3120.22,
      "ClosePrice": 3138.44,
      "HighPrice": 3142.07,
      "LowPrice": 3115.13,
      "Bid": 3138.30,
      "Ask": 3138.58,
      "Volume": 432.58,
      "OpenTime": "2026-03-08T08:00:00Z"
    },
    {
      "SymbolCode": "ETHUSD",
      "OpenPrice": 3138.44,
      "ClosePrice": 3144.11,
      "HighPrice": 3150.90,
      "LowPrice": 3132.50,
      "Bid": 3143.97,
      "Ask": 3144.25,
      "Volume": 509.76,
      "OpenTime": "2026-03-08T09:00:00Z"
    }
  ],
  "TotalCount": 240,
  "CurrentPage": 1,
  "TotalPages": 24,
  "PageSize": 10
}

GEThttps://api.realmarketapi.com/api/v1/candle?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1&pageNumber=1&pageSize=10

{
  "Data": [
    {
      "SymbolCode": "XAUUSD",
      "OpenPrice": 5168.43,
      "ClosePrice": 5174.00,
      "HighPrice": 5176.85,
      "LowPrice": 5165.20,
      "Volume": 1249.33,
      "OpenTime": "2026-03-08T09:20:00Z"
    },
    {
      "SymbolCode": "XAUUSD",
      "OpenPrice": 5162.80,
      "ClosePrice": 5168.43,
      "HighPrice": 5169.75,
      "LowPrice": 5160.50,
      "Volume": 986.17,
      "OpenTime": "2026-03-08T09:19:00Z"
    }
  ],
  "TotalCount": 1440
}

GEThttps://api.realmarketapi.com/api/v1/symbol?apiKey=YOUR_API_KEY

{
  "Data": [
    { "SymbolCode": "XAUUSD", "DisplayName": "Gold / US Dollar",   "MarketClass": "Metals"  },
    { "SymbolCode": "BTCUSD", "DisplayName": "Bitcoin / US Dollar","MarketClass": "Crypto"  },
    { "SymbolCode": "US500",  "DisplayName": "US 500 Index",        "MarketClass": "Indices" }
  ],
  "TotalCount": 12
}

GEThttps://api.realmarketapi.com/api/v1/health

{
  "Status": "Healthy",
  "Timestamp": "2026-03-07T15:05:05.846Z"
}

CONNECTwss://api.realmarketapi.com/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1

{
  "SymbolCode": "XAUUSD",
  "OpenPrice": 5168.43,
  "ClosePrice": 5174.00,
  "HighPrice": 5176.85,
  "LowPrice": 5165.20,
  "Bid": 5173.75,
  "Ask": 5174.25,
  "Volume": 1249.33,
  "OpenTime": "2026-03-08T09:20:00Z"
}

// JavaScript — WebSocket (recommended for live data)
const ws = new WebSocket(
  "wss://api.realmarketapi.com/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"
)

ws.onopen    = () => console.log("[RealMarketAPI] Connected")
ws.onmessage = ({ data }) => {
  const candle = JSON.parse(data)
  console.log(candle.SymbolCode, candle.ClosePrice, candle.Bid, candle.Ask)
}
ws.onerror = (e) => console.error("[RealMarketAPI] WS error", e)
ws.onclose = ()  => console.log("[RealMarketAPI] Disconnected")

# Python — WebSocket example (websockets library)
import asyncio, json, websockets

API_KEY   = "YOUR_API_KEY"
SYMBOL    = "XAUUSD"
TIMEFRAME = "M1"
URI = f"wss://api.realmarketapi.com/price?apiKey={API_KEY}&symbolCode={SYMBOL}&timeFrame={TIMEFRAME}"

async def stream():
    async for ws in websockets.connect(URI):          # auto-reconnect
        try:
            async for message in ws:
                candle = json.loads(message)
                print(candle["SymbolCode"], candle["ClosePrice"], candle["Bid"])
        except websockets.ConnectionClosed:
            print("Disconnected — retrying…")
            continue

asyncio.run(stream())

// JavaScript — Multiple symbols over separate connections
const subscriptions = [
  { symbol: "XAUUSD", timeFrame: "M1" },
  { symbol: "BTCUSD", timeFrame: "M5" },
  { symbol: "EURUSD", timeFrame: "H1" },
]

const connections = subscriptions.map(({ symbol, timeFrame }) => {
  const ws = new WebSocket(
    `wss://api.realmarketapi.com/price?apiKey=YOUR_API_KEY&symbolCode=${symbol}&timeFrame=${timeFrame}`
  )
  ws.onmessage = ({ data }) => handleCandle(JSON.parse(data))
  return ws
})

function handleCandle(candle) {
  // dispatch candle to your state / store
  console.log(candle.SymbolCode, candle.TimeFrame, candle.ClosePrice)
}

// JavaScript — Auto-reconnect pattern (production recommended)
const API_KEY    = "YOUR_API_KEY"
const SYMBOL     = "XAUUSD"
const TIMEFRAME  = "M1"
const WS_URL     = `wss://api.realmarketapi.com/price?apiKey=${API_KEY}&symbolCode=${SYMBOL}&timeFrame=${TIMEFRAME}`

let ws
let reconnectDelay = 1000  // start at 1 s, then back off

function connect() {
  ws = new WebSocket(WS_URL)

  ws.onopen = () => {
    console.log("Connected")
    reconnectDelay = 1000  // reset on successful connection
  }

  ws.onmessage = ({ data }) => {
    const candle = JSON.parse(data)
    // ─── handle incoming candle ────────────────────────────
    console.log(candle.SymbolCode, candle.ClosePrice)
  }

  ws.onclose = () => {
    console.warn(`Disconnected. Reconnecting in ${reconnectDelay}ms…`)
    setTimeout(connect, reconnectDelay)
    reconnectDelay = Math.min(reconnectDelay * 2, 30_000)  // cap at 30 s
  }

  ws.onerror = (e) => console.error("WS error", e)
}

connect()

{
  "StatusCode": 400,
  "Message": "Validation failed for query parameters.",
  "Errors": [
    {
      "PropertyName": "timeFrame",
      "ErrorCode": "ERR_0007_INVALID_TIME_FRAME",
      "ErrorMessage": "timeFrame must be one of M1, M5, M15, H1, H4, D1"
    },
    {
      "PropertyName": "symbolCode",
      "ErrorCode": "ERR_0008_SYMBOL_NOT_SUPPORTED",
      "ErrorMessage": "symbolCode BTCUSDT is not supported"
    }
  ],
  "TraceId": "00-7a8ab3af4fce34f3872a28ec7ca8f5e1-886d2e1bc76dc9a4-00"
}