---
title: "Search wallets"
method: GET
path: "/v1/wallets/search"
tags: ["Wallets"]
---

# Search wallets

`GET /v1/wallets/search`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/wallets/search`
- Auth: HTTP bearer

**Min tier: `free`.** Search by address or Polymarket name. Bounded point search.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Search results.

- object
  - `query` string
  - `results` WalletSearchResult[]
    - `address` string
    - `polymarket_name` string, nullable
    - `total_volume` number, nullable
    - `total_pnl` 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)