RealMarketAPI
📡
Docs/REST Endpoints

REST Endpoints

6 endpoints · Code examples in cURL, JavaScript, Python, C#, and Java

GET

/api/v1/price

Returns the latest completed OHLCV candle for the requested symbol and timeframe. This is a one-shot snapshot endpoint — ideal for server-side cron jobs or one-off queries.

💡Use WebSocket for continuous live data. Polling this endpoint on a timer wastes quota. Connect a WebSocket stream to receive every new candle automatically.
Query Parameters
NameTypeDescription
apiKey*stringYour API key.
symbolCode*stringOne of: XAUUSD, XAGUSD, EURUSD, GBPUSD, USDJPY, GBPJPY, USDVND, AUDUSD, BTCUSD, ETHUSD, XRPUSD, USOIL, UKOIL, XNGUSD, US500, US30, AAPL, TSLA, NFLX, MSFT, AMZN, AMD, NVDA.
timeFrame*stringCandle interval: M1 · M5 · M15 · H1 · H4 · D1.

Request

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

Response — 200 OK

response.json
{
  "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"
}

Code examples

price.sh
curl "https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"
▶️

Try it live in the Playground

Run a live /api/v1/price request with your API key — see the real response instantly in your browser.

Open Playground
GET

/api/v1/history

Returns a paginated list of historical OHLCV candles for H1 timeframe between startTime and endTime. Always returns hourly (H1) candles — timeframe parameter is not available. Does not include the current incomplete bar.

🔒Requires a plan with historical data access. Returns ERR_0010_NOT_SUPPORT_HISTORICAL if your plan does not include history. View plans →
💡Need the current bar? Use /api/v1/candle instead to get the latest open candle with any timeframe.
Query Parameters
NameTypeDescription
apiKey*stringYour API key.
symbolCode*stringMarket symbol code.
startTime*ISO 8601Range start, e.g. 2026-02-01T00:00:00Z.
endTime*ISO 8601Range end, e.g. 2026-03-01T23:59:59Z.
pageNumberinteger1-based page number. Default: 1.
pageSizeintegerCandles per page. Max: 100. Default: 10.

Request

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

Response — 200 OK

response.json
{
  "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"
    }
  ],
  "TotalCount":  240,
  "CurrentPage": 1,
  "TotalPages":  24,
  "PageSize":    10
}

Code examples

history.sh
curl "https://api.realmarketapi.com/api/v1/history?apiKey=YOUR_API_KEY&symbolCode=ETHUSD&startTime=2026-02-01T00:00:00Z&endTime=2026-03-01T00:00:00Z&pageNumber=1&pageSize=10"
▶️

Try it live in the Playground

Run a live /api/v1/history request with your API key — see the real response instantly in your browser.

Open Playground
GET

/api/v1/candle

Returns the 10 most-recent completed OHLCV candles (newest first) for a symbol and timeframe — automatically, no pagination parameters needed. Perfect for seeding a chart with recent bars on first load without needing a date range.

🔒Requires historical data access. Returns ERR_0010_NOT_SUPPORT_HISTORICAL without it.
Query Parameters
NameTypeDescription
apiKey*stringYour API key.
symbolCode*stringMarket symbol code.
timeFrame*stringCandle interval: M1 · M5 · M15 · H1 · H4 · D1. Choose wisely — smaller timeframes return more granular but larger datasets.

Request

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

Response — 200 OK

response.json
{
  "Data": [
    {
      "SymbolCode": "XAUUSD",
      "OpenPrice":  5168.43,
      "ClosePrice": 5174.00,
      "HighPrice":  5176.85,
      "LowPrice":   5165.20,
      "Volume":     1249.33,
      "OpenTime":   "2026-03-08T09:20:00Z"
    }
  ],
  "TotalCount": 1440
}

Code examples

candle.sh
curl "https://api.realmarketapi.com/api/v1/candle?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"
▶️

Try it live in the Playground

Run a live /api/v1/candle request with your API key — see the real response instantly in your browser.

Open Playground
GET

/api/v1/symbol

Returns the list of all symbols accessible with your API key. Use this to dynamically populate symbol selectors in your UI rather than hardcoding codes.

Query Parameters
NameTypeDescription
apiKey*stringYour API key.

Request

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

Response — 200 OK

response.json
{
  "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": 13
}

Code examples

symbol.sh
curl "https://api.realmarketapi.com/api/v1/symbol?apiKey=YOUR_API_KEY"
▶️

Try it live in the Playground

Run a live /api/v1/symbol request with your API key — see the real response instantly in your browser.

Open Playground
GET

/api/v1/indicator/support-resistance

Returns computed support and resistance price levels for a symbol and timeframe. Each level includes the price, the number of times price has tested it (touch count), and the most recent touch timestamp. Useful for automated trade setups, chart annotations, and signal generation.

Additional indicator endpoints

  • GET /api/v1/indicator/sma?apiKey=YOUR_API_KEY&SymbolCode=AAPL&TimeFrame=H1&Period=20
  • GET /api/v1/indicator/ema?apiKey=YOUR_API_KEY&SymbolCode=AUDUSD&TimeFrame=H4&Period=50
  • GET /api/v1/indicator/rsi?apiKey=YOUR_API_KEY&SymbolCode=AAPL&TimeFrame=D1&Period=14
  • GET /api/v1/indicator/macd?apiKey=YOUR_API_KEY&SymbolCode=AUDUSD&TimeFrame=H1&FastPeriod=12&SlowPeriod=26&SignalPeriod=9
🔒Requires Pro plan or above. This endpoint uses historical candle data to compute key price levels. Plans without historical data access will receive a 403 error. View plans →
Query Parameters
NameTypeDescription
apiKey*stringYour API key.
symbolCode*stringOne of: XAUUSD, XAGUSD, EURUSD, GBPUSD, USDJPY, GBPJPY, USDVND, AUDUSD, BTCUSD, ETHUSD, XRPUSD, USOIL, UKOIL, XNGUSD, US500, US30, AAPL, TSLA, NFLX, MSFT, AMZN, AMD, NVDA.
timeFrame*stringCandle interval: M5 · M15 · H1 · H4 · D1.

Request

GET /api/v1/indicator/support-resistance
GEThttps://api.realmarketapi.com/api/v1/indicator/support-resistance?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1

Response — 200 OK

response.json
{
  "SymbolCode": "XAUUSD",
  "TimeFrame":  "H1",
  "Supports": [
    { "Price": 3182.50, "TouchCount": 4, "LastTouchedAt": "2026-03-15T10:00:00Z" },
    { "Price": 3155.00, "TouchCount": 3, "LastTouchedAt": "2026-03-14T14:00:00Z" }
  ],
  "Resistances": [
    { "Price": 3245.00, "TouchCount": 5, "LastTouchedAt": "2026-03-15T17:00:00Z" },
    { "Price": 3280.75, "TouchCount": 2, "LastTouchedAt": "2026-03-12T08:00:00Z" }
  ]
}
Response Fields
FieldTypeDescription
SymbolCodestringMarket symbol code, e.g. XAUUSD.
TimeFramestringCandle interval used to compute the levels.
Supports[]arraySupport levels (price floors where buying pressure has historically appeared).
Supports[].PricenumberPrice of the support level.
Supports[].TouchCountintegerNumber of times price tested this level — higher count = stronger support.
Supports[].LastTouchedAtISO 8601UTC timestamp of the most recent touch on this level.
Resistances[]arrayResistance levels (price ceilings where selling pressure has historically appeared).
Resistances[].PricenumberPrice of the resistance level.
Resistances[].TouchCountintegerNumber of times price tested this level.
Resistances[].LastTouchedAtISO 8601UTC timestamp of the most recent touch on this level.

Code examples

support-resistance.sh
curl "https://api.realmarketapi.com/api/v1/indicator/support-resistance?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1"
▶️

Try it live in the Playground

Run a live /api/v1/indicator/support-resistance request with your API key — see the real response instantly in your browser.

Open Playground
GET

/api/v1/health

Returns the API health status. No authentication required. Use this in uptime monitors, CI pipelines, or health-check endpoints without consuming your quota.

✅Public endpoint — no API key required. Safe to call from health checks or CI without consuming your plan quota.

Request

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

Response — 200 OK

response.json
{
  "Status":    "Healthy",
  "Timestamp": "2026-03-11T15:05:05.846Z"
}

Code examples

health.sh
curl "https://api.realmarketapi.com/api/v1/health"
Response Fields
FieldTypeDescription
Statusstring"Healthy" or "Unhealthy".
TimestampISO 8601UTC timestamp of the health-check response.