Trader Analytics

Get a trader's open/closed positions and derived performance stats

Returns a trader’s positions plus performance metrics computed from a full-inventory scan — served independently of the unified profile so the Positions tab and stats panel can load on their own fetch. Positions are filtered by status (open/closed/all), sorted by current value (largest first), and paginated via limit/offset; has_more indicates another page exists in the filtered set. Market names/icons are resolved only for the returned page, so wallets holding a very large number of positions don’t blow past internal query limits. performance (win rate, total PnL, volume, positions_value, etc.) is always computed over the wallet’s FULL inventory, not just the returned page. include_redeemable additionally includes resolved positions still awaiting on-chain redemption. Public endpoint — no authentication required (trader data is public). Rate-limited per client IP at 30 requests/minute. Responses are cacheable at the edge.

GET

trader-stats

positions

{wallet_address}

Get a trader's open/closed positions and derived performance stats

curl --request GET \
  --url https://data.kairos.trade/trader-stats/positions/{wallet_address}

const options = {method: 'GET'};

fetch('https://data.kairos.trade/trader-stats/positions/{wallet_address}', 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://data.kairos.trade/trader-stats/positions/{wallet_address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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://data.kairos.trade/trader-stats/positions/{wallet_address}"

	req, _ := http.NewRequest("GET", url, nil)

	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://data.kairos.trade/trader-stats/positions/{wallet_address}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "wallet_address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
  "performance": {
    "wallet_address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
    "total_realized_pnl": "1250.4382",
    "total_unrealized_pnl": "300.00",
    "total_pnl": "1550.4382",
    "open_positions": 4,
    "closed_positions": 27,
    "total_positions": 31,
    "winning_positions": 18,
    "losing_positions": 9,
    "win_rate": 0.6667,
    "total_volume": "18420.55",
    "markets_traded": 12,
    "last_updated": "2026-07-22T14:03:11Z",
    "roi_percent": "12.75",
    "positions_value": "420.00",
    "join_date": "2023-11-07T05:31:56Z",
    "profile_views": 340,
    "largest_win": "512.30"
  },
  "open_positions": [
    {
      "market_id": "0xabc123condition",
      "token_id": "10723948572...4",
      "outcome": "YES",
      "size": "150.0",
      "entry_price": "0.42",
      "cost_basis": "63.00",
      "realized_pnl": "0.00",
      "status": "OPEN",
      "provider": "polymarket",
      "market_name": "Will the Fed cut rates in September?",
      "icon": "https://cdn.kairos.trade/markets/abc123.png",
      "current_price": "0.55",
      "unrealized_pnl": "19.50",
      "opened_at": "2023-11-07T05:31:56Z",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "closed_positions": [
    {
      "market_id": "0xabc123condition",
      "token_id": "10723948572...4",
      "outcome": "YES",
      "size": "150.0",
      "entry_price": "0.42",
      "cost_basis": "63.00",
      "realized_pnl": "0.00",
      "status": "OPEN",
      "provider": "polymarket",
      "market_name": "Will the Fed cut rates in September?",
      "icon": "https://cdn.kairos.trade/markets/abc123.png",
      "current_price": "0.55",
      "unrealized_pnl": "19.50",
      "opened_at": "2023-11-07T05:31:56Z",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": false
}

{
  "detail": [
    {}
  ]
}

{
  "error": "Rate limit exceeded: 100 per 1 minute"
}

Path Parameters

wallet_address

string

required

Ethereum or Solana wallet address (validated/normalized as above).

Query Parameters

include_redeemable

boolean

default:false

Include resolved positions still waiting for redemption.

provider

string

Provider override (polymarket, kalshi, opinion, predictfun). Auto-detected if omitted.

limit

integer

default:200

Max positions to return per page (sorted by value, largest first).

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of positions to skip (pagination).

Required range: x >= 0

status

enum<string>

default:all

Filter the returned page by position status.

Available options:

all,

open,

closed

Response

Positions page plus full-inventory performance stats.

A page of a wallet's positions plus performance stats derived from the full inventory in the same scan.

wallet_address

string

required

Example:

"0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b"

performance

object

required

Aggregated trader performance metrics, always computed over the full inventory (not a paginated page).

Show child attributes

open_positions

object[]

required

Show child attributes

closed_positions

object[]

required

Show child attributes

has_more

boolean

default:false

True when more positions exist beyond this page (open+closed combined, sorted by value).

Get a trader's open/closed positions and derived performance stats

curl --request GET \
  --url https://data.kairos.trade/trader-stats/positions/{wallet_address}

const options = {method: 'GET'};

fetch('https://data.kairos.trade/trader-stats/positions/{wallet_address}', 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://data.kairos.trade/trader-stats/positions/{wallet_address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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://data.kairos.trade/trader-stats/positions/{wallet_address}"

	req, _ := http.NewRequest("GET", url, nil)

	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://data.kairos.trade/trader-stats/positions/{wallet_address}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "wallet_address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
  "performance": {
    "wallet_address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
    "total_realized_pnl": "1250.4382",
    "total_unrealized_pnl": "300.00",
    "total_pnl": "1550.4382",
    "open_positions": 4,
    "closed_positions": 27,
    "total_positions": 31,
    "winning_positions": 18,
    "losing_positions": 9,
    "win_rate": 0.6667,
    "total_volume": "18420.55",
    "markets_traded": 12,
    "last_updated": "2026-07-22T14:03:11Z",
    "roi_percent": "12.75",
    "positions_value": "420.00",
    "join_date": "2023-11-07T05:31:56Z",
    "profile_views": 340,
    "largest_win": "512.30"
  },
  "open_positions": [
    {
      "market_id": "0xabc123condition",
      "token_id": "10723948572...4",
      "outcome": "YES",
      "size": "150.0",
      "entry_price": "0.42",
      "cost_basis": "63.00",
      "realized_pnl": "0.00",
      "status": "OPEN",
      "provider": "polymarket",
      "market_name": "Will the Fed cut rates in September?",
      "icon": "https://cdn.kairos.trade/markets/abc123.png",
      "current_price": "0.55",
      "unrealized_pnl": "19.50",
      "opened_at": "2023-11-07T05:31:56Z",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "closed_positions": [
    {
      "market_id": "0xabc123condition",
      "token_id": "10723948572...4",
      "outcome": "YES",
      "size": "150.0",
      "entry_price": "0.42",
      "cost_basis": "63.00",
      "realized_pnl": "0.00",
      "status": "OPEN",
      "provider": "polymarket",
      "market_name": "Will the Fed cut rates in September?",
      "icon": "https://cdn.kairos.trade/markets/abc123.png",
      "current_price": "0.55",
      "unrealized_pnl": "19.50",
      "opened_at": "2023-11-07T05:31:56Z",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": false
}

{
  "detail": [
    {}
  ]
}

{
  "error": "Rate limit exceeded: 100 per 1 minute"
}

Overview

Market Data API

Data API

Execution API

Agora Auction API

REST Guides

Market Data Guides

RPC Guides

RFQ Guides

WebSocket Guides

Krisis Guides

Get a trader's open/closed positions and derived performance stats

Path Parameters

Query Parameters

Response