Position history
curl --request GET \
--url https://api.polynode.dev/v3/perps/wallets/{address}/positions/history \
--header 'x-api-key: <api-key>'import requests
url = "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.polynode.dev/v3/perps/wallets/{address}/positions/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.polynode.dev/v3/perps/wallets/{address}/positions/history")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.polynode.dev/v3/perps/wallets/{address}/positions/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"as_of": 1783739417178,
"entry_price": "59.907",
"instrument_id": 5,
"mark_price": "59.904",
"notional": "6781.612032",
"side": "long",
"size": "113.208",
"symbol": "SILVER-USD",
"unrealized_pnl": "-219.18727674172540875203195559"
},
{
"as_of": 1783739417178,
"entry_price": "4073.5",
"instrument_id": 2,
"mark_price": "4115.6",
"notional": "100854.506552",
"side": "short",
"size": "-24.50542",
"symbol": "GOLD-USD",
"unrealized_pnl": "16.4260769474185793731707450"
}
],
"signer": "0xe666b1fed887af4c9cb8e8f6feb7fc1c537e74a5"
}Perps Analytics
Position History
A wallet’s perps positions over time — how each position changed, opened, or closed, with equity and PnL trajectory. Polymarket only returns a wallet’s current portfolio; this is the accumulated history. Filter by instrument and time window (after/before). A read also captures a fresh snapshot when the latest is stale, so the current state is always included.
GET
/
v3
/
perps
/
wallets
/
{address}
/
positions
/
history
Position history
curl --request GET \
--url https://api.polynode.dev/v3/perps/wallets/{address}/positions/history \
--header 'x-api-key: <api-key>'import requests
url = "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.polynode.dev/v3/perps/wallets/{address}/positions/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.polynode.dev/v3/perps/wallets/{address}/positions/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.polynode.dev/v3/perps/wallets/{address}/positions/history")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.polynode.dev/v3/perps/wallets/{address}/positions/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"as_of": 1783739417178,
"entry_price": "59.907",
"instrument_id": 5,
"mark_price": "59.904",
"notional": "6781.612032",
"side": "long",
"size": "113.208",
"symbol": "SILVER-USD",
"unrealized_pnl": "-219.18727674172540875203195559"
},
{
"as_of": 1783739417178,
"entry_price": "4073.5",
"instrument_id": 2,
"mark_price": "4115.6",
"notional": "100854.506552",
"side": "short",
"size": "-24.50542",
"symbol": "GOLD-USD",
"unrealized_pnl": "16.4260769474185793731707450"
}
],
"signer": "0xe666b1fed887af4c9cb8e8f6feb7fc1c537e74a5"
}Follow one wallet’s perps positions through time — how each position grew, shrank, opened, or closed, with the mark, notional, and unrealized PnL captured at each point. Filter to a single
instrument and bound the window with after / before.
Polymarket returns only a wallet’s current portfolio. This is the accumulated history of it, which exists nowhere else. Coverage begins when we started capturing (July 9, 2026) and grows continuously; each row carries its as_of timestamp. When you query, we also capture a fresh snapshot if the latest one is stale, so the current state is always part of what you get back.
Accepts either address form — profile address or signer — resolved automatically.Authorizations
Path Parameters
Polymarket proxy wallet or signer EOA (0x...). Resolved automatically.
Query Parameters
Restrict to one instrument
Only rows after this time (Unix s or ms)
Only rows before this time
Max rows (default 500)
Response
200 - application/json
Success

