---
title: "Correlated wallets"
method: GET
path: "/v1/wallets/{address}/correlated"
tags: ["Wallets"]
---

# Correlated wallets

`GET /v1/wallets/{address}/correlated`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/wallets/{address}/correlated`
- Auth: HTTP bearer

**Min tier: `free`.** Wallets that traded the same markets on the same side over a 30-day window (live self-join, bounded to 20 anchor markets).

## Path parameters

- `address` string, required

## Query parameters

- `limit` integer

## Response `200`

Correlated wallets.

- object
  - `address` string
  - `correlated` CorrelatedWallet[]
    - `address` string
    - `polymarket_name` string, nullable
    - `shared_markets` integer, nullable
    - `same_side_ratio` number, nullable

## Other responses

- `400`: Malformed parameters or a rejected guardrail (e.g. unfiltered trades query, cluster blowup, window > 90 days).
- `401`: Missing, invalid, or revoked API key. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `403`: Key valid but its tier is below this endpoint's minimum. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `429`: Hourly or monthly rate limit exceeded.

---

[API](https://skmtc.dev/crowdintel/apis/crowdintel-api.md) · [All operations](https://skmtc.dev/crowdintel/apis/crowdintel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crowdintel/apis/crowdintel-api/revisions/7059cfe9320d?raw)