📡

Docs/REST Endpoints

REST Endpoints

7 endpoints · Code examples in cURL, JavaScript, Python, C#, Java, Ruby, and Dart

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/price/market

Returns a market overview with the latest close prices, 24-hour percentage changes, and historical volume data for all symbols accessible with your API key. Results are filtered by your account plan — only symbols included in your plan are returned.

📊Plan-filtered results. The response includes only symbols available in your current plan. HistoryVolumes array length equals the number of hourly candles returned (handler expects at least 24 hourly candles to compute daily percent).

Query Parameters

Name	Type	Description
apiKey*	string	Your API key.
timeFrame	string	Candle interval for change calculation. Default: H1.

Request

GET /api/v1/price/market

GEThttps://api.realmarketapi.com/api/v1/price/market?apiKey=YOUR_API_KEY&timeFrame=H1

Response — 200 OK

response.json

{
  "Data": [
    {
      "SymbolCode": "XAUUSD",
      "LastClosePrice": 5168.43,
      "LastOpenTime": "2026-03-08T09:20:00Z",
      "ChangePercent": 0.85,
      "HistoryVolumes": [1249.33, 1156.78, ..., 1324.56]
    },
    {
      "SymbolCode": "EURUSD",
      "LastClosePrice": 1.0845,
      "LastOpenTime": "2026-03-08T09:20:00Z",
      "ChangePercent": -0.12,
      "HistoryVolumes": [4567.89, 4321.12, ..., 4789.34]
    }
  ],
  "TotalCount": 25
}

Error Responses

400Validation error (missing ApiKey)

401/403Invalid API key or plan restriction

404No market data available

Code examples

market.sh

curl "https://api.realmarketapi.com/api/v1/price/market?apiKey=YOUR_API_KEY&timeFrame=H1"

▶️

Try it live in the Playground

Run a live /api/v1/price/market 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
GET /api/v1/indicator/fibonacci?apiKey=YOUR_API_KEY&SymbolCode=XAUUSD&TimeFrame=H1&Lookback=50

🔒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/indicator/fibonacci

Returns Fibonacci retracement levels calculated from the high and low points over a specified lookback period. Useful for identifying potential support and resistance levels based on Fibonacci ratios.

🔒Requires Pro plan or above. This endpoint uses historical candle data to compute Fibonacci levels. Plans without historical data access will receive a 403 error. View plans →

Query Parameters

Name	Type	Description
`apiKey`	`string`	Your API key for authentication.
`symbolCode`	`string`	Trading symbol (e.g., XAUUSD, AAPL).
`timeFrame`	`string`	Timeframe: M1, M5, M15, H1, H4, D1.
`lookback`	`integer`	Number of candles to look back for high/low calculation (10-200).

Response Schema

Field	Type	Description
`SymbolCode`	`string`	The trading symbol requested.
`TimeFrame`	`string`	The timeframe used for calculation.
`Lookback`	`integer`	The lookback period used.
`High`	`number`	The highest price in the lookback period.
`Low`	`number`	The lowest price in the lookback period.
`Levels`	`object`	Fibonacci retracement levels as key-value pairs.
`Levels.0.236`	`number`	23.6% Fibonacci retracement level.
`Levels.0.382`	`number`	38.2% Fibonacci retracement level.
`Levels.0.500`	`number`	50.0% Fibonacci retracement level.
`Levels.0.618`	`number`	61.8% Fibonacci retracement level.
`Levels.0.786`	`number`	78.6% Fibonacci retracement level.

Request

GET /api/v1/indicator/fibonacci

GEThttps://api.realmarketapi.com/api/v1/indicator/fibonacci?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&lookback=50

Response — 200 OK

response.json

{
  "SymbolCode": "XAUUSD",
  "TimeFrame": "H1",
  "Lookback": 50,
  "High": 3250.00,
  "Low": 3150.00,
  "Levels": {
    "0.236": 3212.00,
    "0.382": 3188.00,
    "0.500": 3200.00,
    "0.618": 3212.00,
    "0.786": 3226.00
  }
}

Error Responses

400Validation error (missing ApiKey, invalid SymbolCode, invalid TimeFrame, Lookback out of range)

401/403Invalid API key or plan restriction (requires Pro+)

404Insufficient historical data for calculation

Code examples

fibonacci.sh

curl "https://api.realmarketapi.com/api/v1/indicator/fibonacci?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&lookback=50"

▶️

Try it live in the Playground

Run a live /api/v1/indicator/fibonacci 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.