GET /candles

OHLCV candles built from this venue's fills.

GEThttps://arc-testnet-api.realtime.exchange/candlesServer network

No authentication

Query parameters

instrument_namestringrequired

e.g. BTC-PERP (or symbol).

resolutionstringrequired

One of the supported resolutions (below). 1M is one MONTH; one minute is 1.

fromintegeroptional

Unix seconds.

tointegeroptional

Unix seconds, default now.

countbackintegeroptional

Number of bars; overrides from.

Response

200

An array, oldest first, of {time, close_time, open, high, low, close, volume, quote_volume, trades, average, taker_buy_volume}. Money values are exact decimal strings.

At most 5000 bars per request.
Only periods with trades are returned (no forward-fill).
To get the most recent bars, send countback (or a from close to to). Without either, you get up to 5000 bars from the start of the market's history.
Instrument names are case-insensitive. A missing or unknown instrument returns 404.
Unsupported resolution → 400; unknown instrument → 404.

GET /candlesLanguage

curl "https://arc-testnet-api.realtime.exchange/candles?instrument_name=AAPL-PERP&resolution=60"

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://arc-testnet-api.realtime.exchange/candles?instrument_name=AAPL-PERP&resolution=60", nil)
	if err != nil {
		panic(err)
	}
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

<?php
$ch = curl_init('https://arc-testnet-api.realtime.exchange/candles?instrument_name=AAPL-PERP&resolution=60');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $response, PHP_EOL;

Response

[]

Real response to GET /candles?instrument_name=AAPL-PERP&resolution=60&countback=5 from arc-testnet-api.realtime.exchange. Addresses and hashes are replaced by placeholders.