📡

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

Name	Type	Description
apiKey*	string	Your API key.
symbolCode*	string	One 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*	string	Candle 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

Name	Type	Description
apiKey*	string	Your API key.
symbolCode*	string	Market symbol code.
startTime*	ISO 8601	Range start, e.g. 2026-02-01T00:00:00Z.
endTime*	ISO 8601	Range end, e.g. 2026-03-01T23:59:59Z.
pageNumber	integer	1-based page number. Default: 1.
pageSize	integer	Candles 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

Name	Type	Description
apiKey*	string	Your API key.
symbolCode*	string	Market symbol code.
timeFrame*	string	Candle 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

Name	Type	Description
apiKey*	string	Your 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

Name	Type	Description
apiKey*	string	Your API key.
symbolCode*	string	One 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*	string	Candle 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

Field	Type	Description
`SymbolCode`	`string`	Market symbol code, e.g. XAUUSD.
`TimeFrame`	`string`	Candle interval used to compute the levels.
`Supports[]`	`array`	Support levels (price floors where buying pressure has historically appeared).
`Supports[].Price`	`number`	Price of the support level.
`Supports[].TouchCount`	`integer`	Number of times price tested this level — higher count = stronger support.
`Supports[].LastTouchedAt`	`ISO 8601`	UTC timestamp of the most recent touch on this level.
`Resistances[]`	`array`	Resistance levels (price ceilings where selling pressure has historically appeared).
`Resistances[].Price`	`number`	Price of the resistance level.
`Resistances[].TouchCount`	`integer`	Number of times price tested this level.
`Resistances[].LastTouchedAt`	`ISO 8601`	UTC 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

Field	Type	Description
`Status`	`string`	"Healthy" or "Unhealthy".
`Timestamp`	`ISO 8601`	UTC timestamp of the health-check response.