---
title: "Aggregated large-trader wallet activity"
method: GET
path: "/api/prediction-markets/whales/wallets"
tags: ["public-pm-data"]
---

# Aggregated large-trader wallet activity

`GET /api/prediction-markets/whales/wallets`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/prediction-markets/whales/wallets`
- Auth: none required

Observed-window wallet aggregation behind the public whales surface. On-chain
venues only, so absence of a wallet is not evidence of absence of
trading — it means the venue does not expose one.

## Query parameters

- `window` '7d' | '30d'
- `source` 'polymarket' | 'limitless' | 'myriad'

## Response `200`

Wallet rows with aggregated flow

- object
  - `window` '7d' | '30d'
  - `venues` string[]
  - `wallets` object[]
    - `wallet` string
    - `address` string
    - `traderName` string, nullable
    - `venues` object[]
    - `tradeCount` number
    - `totalUsd` number
    - `maxUsd` number
    - `firstSeen` string, date-time, nullable
    - `lastSeen` string, date-time, nullable

## Other responses

- `400`: Invalid or missing parameters. On a route with a query allowlist, an undocumented query parameter returns `{"error": "unsupported_query_parameter", "message": "Unsupported query parameter: <key>. Supported: <keys>."}`.
- `429`: Public request rate limit exceeded; honor `Retry-After`.
- `500`: Server error
- `503`: Server error

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)
