> ## 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.
# Similar Wallets
> Find wallets with similar market portfolios
Detect potential copy-trading patterns and discover traders with similar strategies. Finds all markets the target wallet has traded, then ranks other wallets by overlap percentage and count.
**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 50) |
## OpenAPI
````yaml GET /v2/polymarket/wallet/{wallet}/similar
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}/similar:
get:
tags:
- polymarket
- smart-wallet
summary: Get Similar Wallets
description: |-
Find wallets with similar market portfolios (copy-trade detection).
**Use Case:**
- Find wallets that trade similar markets to a target wallet
- Detect potential copy-trading patterns
- Discover traders with similar strategies
**How it works:**
1. Get all markets the target wallet has traded
2. Find other wallets that traded the same markets
3. Rank by overlap percentage and count
operationId: get_similar_wallets_v2_polymarket_wallet__wallet__similar_get
parameters:
- name: wallet
in: path
required: true
schema:
type: string
description: Target wallet address
title: Wallet
description: Target wallet address
- name: window
in: query
required: false
schema:
$ref: '#/components/schemas/TimeWindow'
description: Time window for metrics
default: all_time
description: Time window for metrics
- name: min_overlap_pct
in: query
required: false
schema:
anyOf:
- type: number
maximum: 1
minimum: 0
- type: 'null'
description: >-
Minimum overlap percentage (0-1). E.g., 0.5 = at least 50% market
overlap
title: Min Overlap Pct
description: >-
Minimum overlap percentage (0-1). E.g., 0.5 = at least 50% market
overlap
- name: min_overlap_markets
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
- type: 'null'
description: Minimum number of overlapping markets
title: Min Overlap Markets
description: Minimum number of overlapping markets
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Results per page
default: 50
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/WalletSimilarityResponse'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'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.
WalletSimilarityResponse:
properties:
target_wallet:
type: string
title: Target Wallet
description: The wallet we're finding similar wallets for
target_market_count:
type: integer
title: Target Market Count
description: Number of markets the target wallet has traded
window:
$ref: '#/components/schemas/TimeWindow'
description: Time window for metrics
similar_wallets:
items:
$ref: '#/components/schemas/SimilarWalletEntry'
type: array
title: Similar Wallets
description: Wallets with similar market portfolios
pagination:
$ref: '#/components/schemas/CursorPagination'
description: Pagination info
type: object
required:
- target_wallet
- target_market_count
- window
- similar_wallets
- pagination
title: WalletSimilarityResponse
description: Response for wallet similarity endpoint.
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
SimilarWalletEntry:
properties:
rank:
type: integer
title: Rank
description: Similarity rank (1 = most similar)
user:
type: string
title: User
description: Wallet address
markets_overlap:
type: integer
title: Markets Overlap
description: Number of markets traded by both wallets
overlap_pct:
type: number
title: Overlap Pct
description: Percentage of target's markets also traded by this wallet (0-1)
total_markets:
type: integer
title: Total Markets
description: Total markets this wallet has traded
metrics:
$ref: '#/components/schemas/WindowMetrics'
description: This wallet's global metrics
type: object
required:
- rank
- user
- markets_overlap
- overlap_pct
- total_markets
- metrics
title: SimilarWalletEntry
description: A wallet similar to the target 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
````