GET /balance-history

Your recorded account equity over time (the portfolio chart).

GEThttps://arc-testnet-api.realtime.exchange/balance-historyServer network

API key required (API-KEY + API-SECRET headers)

Authorization

API-KEYstringrequired

Your API key. Create one →

API-SECRETstringrequired

The secret shown once when the key was created.

Query parameters

start_timeintegerrequired

Unix time (s, ms or ns).

end_timeintegeroptional

Default now.

resolutionintegeroptional

Seconds per point, default 3600. Clamped to 60–604800, then coarsened so the response has at most 2000 points (operator-configurable).

Response

200

{history: [[unix_seconds, equity], ...]}, oldest first.

start_time after end_time returns 400.
Requires a real API key — the account header alone is rejected.
History starts when the server began recording snapshots for your account. Snapshots are taken only while the account has a live API key or an open private WebSocket.
Points older than 8 days are thinned to hourly; points older than 400 days are deleted (server defaults).

GET /balance-historyLanguage

curl "https://arc-testnet-api.realtime.exchange/balance-history?start_time=<start_time>&resolution=60" \
  -H "API-KEY: $API_KEY" \
  -H "API-SECRET: $API_SECRET"

const res = await fetch('https://arc-testnet-api.realtime.exchange/balance-history?start_time=<start_time>&resolution=60', {
  headers: {
    'API-KEY': process.env.API_KEY,
    'API-SECRET': process.env.API_SECRET,
  },
});
const data = await res.json();
console.log(res.status, data);

import os
import requests

res = requests.get("https://arc-testnet-api.realtime.exchange/balance-history?start_time=<start_time>&resolution=60", headers={
    "API-KEY": os.environ["API_KEY"],
    "API-SECRET": os.environ["API_SECRET"],
})
print(res.status_code, res.json())

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://arc-testnet-api.realtime.exchange/balance-history?start_time=<start_time>&resolution=60", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("API-KEY", os.Getenv("API_KEY"))
	req.Header.Set("API-SECRET", os.Getenv("API_SECRET"))
	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/balance-history?start_time=<start_time>&resolution=60');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'API-KEY: ' . getenv('API_KEY'),
        'API-SECRET: ' . getenv('API_SECRET'),
    ],
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $response, PHP_EOL;

Response

{history: [[unix_seconds, equity], ...]}, oldest first.