---
title: "Connected wallets for an address (graph-based)"
method: GET
path: "/v2/polymarket/wallet/{address}/cluster"
tags: ["polymarket"]
---

# Connected wallets for an address (graph-based)

`GET /v2/polymarket/wallet/{address}/cluster`

Returns sibling wallets discovered via the on-chain transfer graph (USDC, pUSD, CTF) plus identity-proof signals (shared signer, shared X username, shared first funder). Confidence is 0-100; ≥70 indicates strong evidence. On a cache miss the endpoint returns 202 and computes the cluster in the background — the next call returns the full result.

## Path parameters

- `address` string, required — Seed wallet address (proxy or signer).

## Query parameters

- `min_confidence` integer — Minimum confidence to include (default 70 = strong-only).
- `limit` integer — Max siblings to return.
- `recompute` boolean — Kick off a fresh background BFS even if a cached result exists.

## Response `200`

Successful Response

- WalletClusterResponse — Connected wallets for a seed wallet.
  - `seed` string, required — Seed wallet address
  - `siblings` ClusterSiblingEntry[], required — Top sibling wallets by confidence
    - `address` string, required — Sibling wallet address
    - `confidence` integer, required — Confidence score 0-100
    - `min_hops` integer, required — Shortest path from seed to sibling
    - `evidence` object, required — Evidence object for the sibling relation
  - `computed_at` integer, nullable — Unix timestamp when this cluster was last computed

## Other responses

- `202` — Compute in progress. Retry after the indicated interval.
- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[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/versions/80a306fbdb39/schema)