---
title: "Get Similar Wallets"
method: GET
path: "/v2/polymarket/wallet/{wallet}/similar"
tags: ["polymarket", "smart-wallet"]
---

# Get Similar Wallets

`GET /v2/polymarket/wallet/{wallet}/similar`

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

## Path parameters

- `wallet` string, required — Target wallet address

## Query parameters

- `window` '1d' | '7d' | '30d' | 'all_time' — Time window for rolling metrics.
- `min_overlap_pct` number, nullable — Minimum overlap percentage (0-1). E.g., 0.5 = at least 50% market overlap
- `min_overlap_markets` integer, nullable — Minimum number of overlapping markets
- `limit` integer — Results per page
- `pagination_key` string, nullable — Cursor for pagination

## Response `200`

Successful Response

- WalletSimilarityResponse — Response for wallet similarity endpoint.
  - `target_wallet` string, required — The wallet we're finding similar wallets for
  - `target_market_count` integer, required — Number of markets the target wallet has traded
  - `window` '1d' | '7d' | '30d' | 'all_time', required — Time window for rolling metrics.
  - `similar_wallets` SimilarWalletEntry[], required — Wallets with similar market portfolios
    - `rank` integer, required — Similarity rank (1 = most similar)
    - `user` string, required — Wallet address
    - `markets_overlap` integer, required — Number of markets traded by both wallets
    - `overlap_pct` number, required — Percentage of target's markets also traded by this wallet (0-1)
    - `total_markets` integer, required — Total markets this wallet has traded
    - `metrics` WindowMetrics, required — Metrics for a specific time window.
      - `realized_pnl` number, required — Realized profit/loss in USD (from closed positions)
      - `total_pnl` number, nullable — Total PnL in USD (realized + unrealized - net fees)
      - `volume` number, required — Trading volume in USD
      - `roi` number, required — Return on investment (decimal, e.g., 0.5 = 50%)
      - `trades` integer, required — Number of trades
      - `wins` integer, required — Number of winning positions closed
      - `losses` integer, required — Number of losing positions closed
      - `win_rate` number, required — Win rate (decimal, e.g., 0.6 = 60%)
      - `profit_factor` number, required — Profit factor (gross profit / gross loss)
      - `positions_closed` integer, required — Number of positions closed
      - `avg_buy_price` number, nullable — Volume-weighted average buy price (0-1)
      - `avg_sell_price` number, nullable — Volume-weighted average sell price (0-1)
      - `fees_paid` number — Taker fees paid in USD
      - `fees_refunded` number — DEPRECATED: always 0. Refunds are already netted into fees_paid.
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Validation Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)