Skip to main content
GET
/
v2
/
polymarket
/
wallet
/
{address}
/
cluster
Connected wallets for an address (graph-based)
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/wallet/{address}/cluster \
  --header 'x-api-key: <api-key>'
{
  "seed": "<string>",
  "siblings": [
    {
      "address": "<string>",
      "confidence": 50,
      "min_hops": 123,
      "evidence": {}
    }
  ],
  "computed_at": 123
}

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.

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). Use this to surface likely-related accounts behind a single operator — alt wallets, hot/cold splits, multi-account farming patterns.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.

​
How confidence works

Each sibling carries a confidence score from 0 to 100. Scores ≥70 indicate strong evidence (the default min_confidence). Lower the threshold to surface weaker links — useful for exploratory investigation, noisier for automated workflows.

​
Behavior

  • Computes live on cache miss via BFS over the transfer graph, then writes through to the wallet-cluster cache.
  • Pass recompute=true to force a fresh BFS even when a cached result exists.
  • The seed address can be either a proxy or a signer — both are normalized.
  • min_hops reports the shortest path from the seed to each sibling in the transfer graph (0 = direct).
  • The evidence object is free-form and may include bidirectional flow signals, classification, verified-trader flag, direct-flow tx counts/amounts, and identity proofs (same_signer, same_x_username, shared_first_funder).
ConstraintValue
min_confidence0–100 (default 70)
limit1–200 (default 50)

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
address
string
required

Seed wallet address (proxy or signer).

Query Parameters

​
min_confidence
integer
default:70

Minimum confidence to include (default 70 = strong-only).

Required range: 0 <= x <= 100
​
limit
integer
default:50

Max siblings to return.

Required range: 1 <= x <= 200
​
recompute
boolean
default:false

Force a fresh BFS even if a cached result exists.

Response

Successful Response

Connected wallets for a given seed, sourced from the wallet-cluster job.

​
seed
string
required

The seed wallet address (lower-cased)

​
siblings
ClusterSiblingEntry · object[]
required

Top-N siblings by confidence

​
computed_at
integer | null

Unix timestamp when this cluster was last computed (None if cache miss).