GET /positions

Open positions, cursor-paginated.

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

SPOT or PERPETUAL (case-insensitive).

assetstringoptional

limitintegeroptional

1–1000, default 50.

cursorstringoptional

From pagination.next_cursor / prev_cursor.

directionstringoptional

next (default) or prev.

Response

200

{positions: [...], pagination: {next_cursor, prev_cursor, has_next, has_prev, limit, total_count, total_pages}}

GET /positionsLanguage

curl "https://arc-testnet-api.realtime.exchange/positions?instrument_type=PERPETUAL&asset=AAPL" \
  -H "API-KEY: $API_KEY" \
  -H "API-SECRET: $API_SECRET"

const res = await fetch('https://arc-testnet-api.realtime.exchange/positions?instrument_type=PERPETUAL&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/positions?instrument_type=PERPETUAL&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/positions?instrument_type=PERPETUAL&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/positions?instrument_type=PERPETUAL&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

{positions: [...], pagination: {next_cursor, prev_cursor, has_next, has_prev, limit, total_count, total_pages}}