GET /position-history

Closed perpetual positions (one row per position cycle), cursor-paginated.

GEThttps://arc-testnet-api.realtime.exchange/position-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

instrument_namestringoptional

assetstringoptional

start_timeintegeroptional

end_timeintegeroptional

sort_orderstringoptional

limitintegeroptional

cursorstringoptional

directionstringoptional

Response

200

{position_history: [...], pagination}

GET /position-historyLanguage

curl "https://arc-testnet-api.realtime.exchange/position-history?instrument_name=AAPL-PERP&asset=AAPL" \
  -H "API-KEY: $API_KEY" \
  -H "API-SECRET: $API_SECRET"

const res = await fetch('https://arc-testnet-api.realtime.exchange/position-history?instrument_name=AAPL-PERP&asset=AAPL', {
  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/position-history?instrument_name=AAPL-PERP&asset=AAPL", 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/position-history?instrument_name=AAPL-PERP&asset=AAPL", 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/position-history?instrument_name=AAPL-PERP&asset=AAPL');
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

{position_history: [...], pagination}