Wallet P&L

curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{address}/pnl \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v3/wallets/{address}/pnl', 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/wallets/{address}/pnl",
  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/wallets/{address}/pnl"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v3/wallets/{address}/pnl")

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

GET

wallets

{address}

pnl

Wallet P&L

curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{address}/pnl \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v3/wallets/{address}/pnl', 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/wallets/{address}/pnl",
  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/wallets/{address}/pnl"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v3/wallets/{address}/pnl")

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

Returns P&L data for a wallet in USD. Without a period parameter, returns all-time P&L. With period, after, or before, returns realized P&L for that time window. The two modes have different counting semantics: all-time wins and losses are position counts; time-windowed wins, losses, and events are realized P&L event counts. Do not compare the counts directly.

Wallet P&L supports focused market filters such as category, tags/tag_slug, market/market_slug, event_slug, and condition_id. For leaderboard views, use one primary filter dimension per request.

Request

GET /v3/wallets/{address}/pnl

Query parameters

Parameter	Type	Default	Description
`period`	string	—	Time window: `1d`, `7d`, `30d`, `1y`
`after`	integer	—	Start timestamp (Unix seconds). Time-windowed queries clamp values below `1` to `1`.
`before`	integer	—	End timestamp (Unix seconds)
`category`	string	—	Filter to one market category, case-insensitive
`tags`	string	—	Comma-separated tag slugs to filter by, case-insensitive (e.g. `politics,crypto`, `nfl`, `Iran`)
`tag_slug`	string	—	Alias for a single `tags` value
`market`	string	—	Filter by condition ID or market slug
`market_slug`	string	—	Filter by market slug
`event_slug`	string	—	Filter by parent event slug
`condition_id`	string	—	Filter by market condition ID
`include_unrealized`	string	`false`	Set to `true` to include current unrealized P&L alongside the realized event-window result. Only applies to time-filtered queries.
`include_combos`	boolean	`false`	Add combo position P&L to all-time wallet P&L. If the wallet has no combo exposure, the response remains 200 with a zero combo contribution.

Examples

All-time P&L

curl https://api.polynode.dev/v3/wallets/0x56687bf447db6ffa42ffe2204a05edaa20f55839/pnl

All-time P&L including combos

curl "https://api.polynode.dev/v3/wallets/0x63613e3b96f418332d43cd2af8dc321014d15907/pnl?include_combos=true"

{
  "address": "0x63613e3b96f418332d43cd2af8dc321014d15907",
  "net_realized_pnl": 113.510513,
  "realized_pnl": 113.510513,
  "gross_profit": 184.901354,
  "gross_loss": -71.390841,
  "unrealized_pnl": 0.0,
  "total_pnl": 113.510513,
  "position_count": 21496,
  "open_positions": 1495,
  "total_volume": 129.837476,
  "include_combos": true,
  "included_position_types": ["market", "combo"],
  "combo_pnl": {
    "position_type": "combo",
    "included": true,
    "realized_pnl": 113.510513,
    "unrealized_pnl": 0.0,
    "total_pnl": 113.510513,
    "position_count": 21492,
    "open_positions": 1495
  }
}

For time-windowed or tag-filtered P&L, the response stays successful. If combo P&L cannot be safely added to that filtered view, combo_pnl.included is false and the standard market P&L fields remain unchanged.

{
  "address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "net_realized_pnl": 22053845.825455,
  "gross_profit": 22057977.181649,
  "gross_loss": -4131.356194,
  "unrealized_pnl": 0.000688755,
  "total_pnl": 22053845.826143753,
  "position_count": 22,
  "open_positions": 1,
  "total_volume": 43013258.515682,
  "wins": 18,
  "losses": 4,
  "elapsed_ms": 41
}

30-day P&L

curl https://api.polynode.dev/v3/wallets/0xbddf61af533ff524d27154e589d2d7a81510c684/pnl?period=30d

{
  "address": "0xbddf61af533ff524d27154e589d2d7a81510c684",
  "realized_pnl": 1815261.28,
  "gross_profit": 1918402.27,
  "gross_loss": -103140.98,
  "wins": 33039,
  "losses": 58867,
  "events": 91906,
  "source": "realized_pnl_series",
  "period": "30d",
  "after": 1776134996,
  "before": 1778726996,
  "elapsed_ms": 5902
}

Filtered P&L

curl "https://api.polynode.dev/v3/wallets/0x952d11ebff81d6bd3185e608ed3515b94618ab8a/pnl?category=crypto"
curl "https://api.polynode.dev/v3/wallets/0x952d11ebff81d6bd3185e608ed3515b94618ab8a/pnl?tag_slug=us-election&period=30d"
curl "https://api.polynode.dev/v3/wallets/0x952d11ebff81d6bd3185e608ed3515b94618ab8a/pnl?market_slug=will-donald-trump-win-the-popular-vote-in-the-2024-presidential-election"
curl "https://api.polynode.dev/v3/wallets/0x952d11ebff81d6bd3185e608ed3515b94618ab8a/pnl?event_slug=presidential-election-popular-vote-winner-2024"

30-day P&L with unrealized

Pass include_unrealized=true to include current unrealized P&L alongside the realized event-window result.

curl https://api.polynode.dev/v3/wallets/0xbddf61af533ff524d27154e589d2d7a81510c684/pnl?period=30d&include_unrealized=true

{
  "address": "0xbddf61af533ff524d27154e589d2d7a81510c684",
  "realized_pnl": 1815261.28,
  "gross_profit": 1918402.27,
  "gross_loss": -103140.98,
  "unrealized_pnl": 14714.71,
  "total_pnl": 1829975.99,
  "open_positions_at_date": 363,
  "wins": 33039,
  "losses": 58867,
  "events": 91906,
  "source": "realized_pnl_series",
  "period": "30d",
  "after": 1776135002,
  "before": 1778727002,
  "elapsed_ms": 3803
}

Response fields (all-time)

Field	Type	Description
`net_realized_pnl`	number	Net realized P&L (USD)
`gross_profit`	number	Sum of winning positions (USD)
`gross_loss`	number	Sum of losing positions (USD, negative)
`unrealized_pnl`	number	Paper P&L from open positions (USD)
`total_pnl`	number	`net_realized_pnl + unrealized_pnl` (USD)
`wins`	integer	Winning position count
`losses`	integer	Losing position count
`position_count`	integer	Total positions
`open_positions`	integer	Currently held positions
`total_volume`	number	Total volume traded (USD)
`include_combos`	boolean	Present when `include_combos=true` was requested
`included_position_types`	array	Position families included in aggregate totals
`combo_pnl`	object	Combo-only contribution to the aggregate response

Response fields (with period)

Field	Type	Description
`realized_pnl`	number	Realized P&L in the time window (USD)
`gross_profit`	number	Sum of winning events in the window (USD)
`gross_loss`	number	Sum of losing events in the window (USD, negative)
`wins`	integer	Winning event count
`losses`	integer	Losing event count
`events`	integer	Total P&L events in the window
`period`	string	The requested period
`after`	integer	Start timestamp (Unix seconds)
`before`	integer	End timestamp (Unix seconds)
`source`	string	Dataset label for time-windowed queries

Additional fields (with `include_unrealized=true`)

Field	Type	Description
`unrealized_pnl`	number	Current unrealized P&L for open positions (USD), returned alongside the realized event-window result.
`total_pnl`	number	`realized_pnl + unrealized_pnl` (USD)
`open_positions_at_date`	integer	Current open position count returned with the unrealized P&L estimate

Authorizations

x-api-key

string

header

required

Path Parameters

address

string

required

Wallet address

Query Parameters

period

enum<string>

Time window shortcut

Available options:

1d,

7d,

30d,

1y

after

integer

Unix timestamp lower bound

before

integer

Unix timestamp upper bound

include_unrealized

boolean

default:false

Include current unrealized P&L alongside time-windowed realized P&L

Response

Wallet P&L

​Request

​Query parameters

​Examples

​All-time P&L

​All-time P&L including combos

​30-day P&L

​Filtered P&L

​30-day P&L with unrealized

​Response fields (all-time)

​Response fields (with period)

​Additional fields (with include_unrealized=true)

Authorizations

Path Parameters

Query Parameters

Response

Request

Query parameters

Examples

All-time P&L

All-time P&L including combos

30-day P&L

Filtered P&L

30-day P&L with unrealized

Response fields (all-time)

Response fields (with period)

Additional fields (with `include_unrealized=true`)