> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Wallet Markets
> Get per-market performance breakdown for a wallet
Shows performance metrics for each market the wallet has traded in. Sort by PnL, volume, ROI, or other metrics to find a wallet's best and worst trades.
**Requires Dev or Pro tier.** This endpoint is not available on the Free tier.
**Rolling total PnL accuracy timeline** - Total PnL (realized + unrealized - net fees) uses rolling windows that need time to accumulate full data:
* **All-time total PnL**: accurate immediately (February 10, 2026)
* **1-day rolling total PnL**: fully accurate starting February 11, 2026
* **7-day rolling total PnL**: fully accurate starting February 17, 2026
* **30-day rolling total PnL**: fully accurate starting March 12, 2026
| Constraint | Value |
| ---------- | ------------------- |
| `limit` | 1–100 (default 100) |
## OpenAPI
````yaml GET /v2/polymarket/wallet/{wallet}/markets
openapi: 3.1.0
info:
title: Predexon API
description: Prediction market data aggregation and matching API
version: 2.0.0
servers:
- url: https://api.predexon.com
security:
- apiKey: []
paths:
/v2/polymarket/wallet/{wallet}/markets:
get:
tags:
- polymarket
- smart-wallet
summary: Get Wallet Markets
description: |-
Get per-market breakdown for a wallet.
Shows performance metrics for each market the wallet has traded in.
operationId: get_wallet_markets_v2_polymarket_wallet__wallet__markets_get
parameters:
- name: wallet
in: path
required: true
schema:
type: string
description: Wallet address
title: Wallet
description: Wallet address
- name: window
in: query
required: false
schema:
$ref: '#/components/schemas/TimeWindow'
description: Time window
default: all_time
description: Time window
- name: sort_by
in: query
required: false
schema:
$ref: '#/components/schemas/LeaderboardSortBy'
description: Sort field
default: total_pnl
description: Sort field
- name: order
in: query
required: false
schema:
$ref: '#/components/schemas/OrderDirection'
description: Sort order
default: desc
description: Sort order
- name: min_trades
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
- type: 'null'
description: Minimum trades per market
title: Min Trades
description: Minimum trades per market
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Results per page
default: 100
title: Limit
description: Results per page
- name: pagination_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Cursor for pagination
title: Pagination Key
description: Cursor for pagination
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WalletMarketsResponse'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Service Unavailable
components:
schemas:
TimeWindow:
type: string
enum:
- 1d
- 7d
- 30d
- all_time
title: TimeWindow
description: Time window for rolling metrics.
LeaderboardSortBy:
type: string
enum:
- realized_pnl
- total_pnl
- volume
- roi
- profit_factor
- win_rate
- trades
title: LeaderboardSortBy
description: Sort options for leaderboard.
OrderDirection:
type: string
enum:
- asc
- desc
title: OrderDirection
description: Sort order direction enum.
WalletMarketsResponse:
properties:
user:
type: string
title: User
description: Wallet address
window:
$ref: '#/components/schemas/TimeWindow'
description: Time window for metrics
markets:
items:
$ref: '#/components/schemas/WalletMarketEntry'
type: array
title: Markets
description: Per-market metrics
pagination:
$ref: '#/components/schemas/CursorPagination'
description: Pagination info
type: object
required:
- user
- window
- markets
- pagination
title: WalletMarketsResponse
description: Response for wallet's per-market breakdown.
ErrorResponse:
properties:
error:
type: string
title: Error
message:
type: string
title: Message
type: object
required:
- error
- message
title: ErrorResponse
description: Standard error response.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
WalletMarketEntry:
properties:
condition_id:
type: string
title: Condition Id
description: Market condition ID
title:
anyOf:
- type: string
- type: 'null'
title: Title
description: Market title (resolved from market_state)
market_slug:
anyOf:
- type: string
- type: 'null'
title: Market Slug
description: Market slug for URL construction
metrics:
$ref: '#/components/schemas/WindowMetrics'
description: Metrics for selected window
entry_edge:
anyOf:
- type: number
- type: 'null'
title: Entry Edge
description: Price edge for this market
first_trade_at:
anyOf:
- type: integer
- type: 'null'
title: First Trade At
description: First trade timestamp in this market
last_trade_at:
anyOf:
- type: integer
- type: 'null'
title: Last Trade At
description: Last trade timestamp in this market
type: object
required:
- condition_id
- metrics
title: WalletMarketEntry
description: Per-market metrics for a wallet.
CursorPagination:
properties:
limit:
type: integer
title: Limit
description: Requested limit
count:
type: integer
title: Count
description: Number of items in current response
pagination_key:
anyOf:
- type: string
- type: 'null'
title: Pagination Key
description: Base64-encoded cursor for next page
has_more:
type: boolean
title: Has More
description: Whether there are more items available
type: object
required:
- limit
- count
- has_more
title: CursorPagination
description: Cursor-based pagination for endpoints that don't support offset.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
WindowMetrics:
properties:
realized_pnl:
type: number
title: Realized Pnl
description: Realized profit/loss in USD (from closed positions)
total_pnl:
anyOf:
- type: number
- type: 'null'
title: Total Pnl
description: Total PnL in USD (realized + unrealized - net fees)
volume:
type: number
title: Volume
description: Trading volume in USD
roi:
type: number
title: Roi
description: Return on investment (decimal, e.g., 0.5 = 50%)
trades:
type: integer
title: Trades
description: Number of trades
wins:
type: integer
title: Wins
description: Number of winning positions closed
losses:
type: integer
title: Losses
description: Number of losing positions closed
win_rate:
type: number
title: Win Rate
description: Win rate (decimal, e.g., 0.6 = 60%)
profit_factor:
type: number
title: Profit Factor
description: Profit factor (gross profit / gross loss)
positions_closed:
type: integer
title: Positions Closed
description: Number of positions closed
avg_buy_price:
anyOf:
- type: number
- type: 'null'
title: Avg Buy Price
description: Volume-weighted average buy price (0-1)
avg_sell_price:
anyOf:
- type: number
- type: 'null'
title: Avg Sell Price
description: Volume-weighted average sell price (0-1)
fees_paid:
type: number
title: Fees Paid
description: Taker fees paid in USD
default: 0
fees_refunded:
type: number
title: Fees Refunded
description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
default: 0
type: object
required:
- realized_pnl
- volume
- roi
- trades
- wins
- losses
- win_rate
- profit_factor
- positions_closed
title: WindowMetrics
description: Metrics for a specific time window.
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
````