Skip to main content
GET
Portfolio
Get portfolio summary with exposure and concentration metrics.

Overview

Returns aggregated portfolio data including:
  • Per-venue buckets: polymarket, kalshi — each with balance, pnl, positions_count, total_exposure
  • total: summed counts and exposure across venues (units are mixed — use per-venue buckets for financially accurate aggregation)
  • Flat legacy fields (balance_usdc, positions_count, etc.) kept populated for backwards compatibility
  • Concentration metrics: top market and top 3 markets as percentage of portfolio
  • Warnings: automatic risk alerts (e.g. high concentration)

Query Parameters

Venue-aware response. The polymarket, kalshi, and total buckets are the preferred shape. Use ?venue=polymarket or ?venue=kalshi to filter. The legacy flat fields (balance_usdc, positions_count, total_exposure) remain populated for backwards compatibility, but positions_count only counts Polymarket positions — use the per-venue buckets for accurate counts.

Example

Response Example

Authorizations

Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

venue
enum<string>
default:all

Venue filter: all, polymarket, or kalshi. Per-venue buckets reflect this filter.

Available options:
all,
polymarket,
kalshi

Response

200 - application/json

Successful Response

balance_usdc
number | null

Total USDC balance (legacy)

Example:

523.5

total_exposure
number | null

Total exposure (legacy)

Example:

350

positions_count
integer | null

Open positions count (legacy – Polymarket only)

Example:

5

redeemable_count
integer | null

Redeemable positions count

Example:

2

pnl_24h
number | null

PnL in the last 24h

pnl_total
number | null

Total all-time PnL

Example:

100.5

concentration
object
warnings
string[]

Risk warnings

polymarket
object
kalshi
object
total
object