GET /funding-history/:instrument_name

Recent hourly funding rates of a perpetual market.

GEThttps://arc-testnet-api.realtime.exchange/funding-history/{instrument_name}Server network

No authentication

Path parameters

instrument_namestringrequired

Query parameters

limitintegeroptional

Default 50. Values outside 1–500 are clamped.

start_timeintegeroptional

Earliest settlement time, in seconds, milliseconds or nanoseconds (the unit is inferred from the size).

end_timeintegeroptional

Latest settlement time, in the same units as start_time.

Response

200

{funding_history: [[instrument_name, time_ns, rate, mark_price], ...]}, oldest first.

One row per settled funding hour, stored in the backend database, so history survives restarts.

GET /funding-history/{instrument_name}Language

curl "https://arc-testnet-api.realtime.exchange/funding-history/AAPL-PERP"

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://arc-testnet-api.realtime.exchange/funding-history/AAPL-PERP", 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/funding-history/AAPL-PERP');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $response, PHP_EOL;

Response

{
  "funding_history": [
    [
      "AAPL-PERP",
      "1790589612123000000",
      "0",
      "340.54"
    ],
    [
      "AAPL-PERP",
      "1790593210522000000",
      "0",
      "340.51"
    ]
  ]
}

Real response to GET /funding-history/AAPL-PERP from arc-testnet-api.realtime.exchange. Addresses and hashes are replaced by placeholders.