---
title: "Per-market trader aggregates"
method: GET
path: "/v1/markets"
tags: ["Board"]
---

# Per-market trader aggregates

`GET /v1/markets`

## Request

- Base URL: `https://api.pmwallets.com`
- URL: `https://api.pmwallets.com/v1/markets`
- Auth: one of:
  - none
  - API key in header `x-api-key`

The busiest markets of the 30d window (up to 1,000, at least 20 traders each) with counts and sums over traders, never any one trader. Same answer for everyone; may serve the previous run while a new one loads.

## Response `200`

OK

- object
  - `periodId` string
  - `b0` integer
  - `b1` integer
  - `completedAt` string
  - `markets` MarketStat[]
    - `conditionId` string
    - `slug` string
    - `question` string
    - `eventSlug` string
    - `eventTitle` string
    - `category` string
    - `traders` integer
    - `boughtUsdc` number
    - `soldUsdc` number
    - `fills` integer
    - `resolved` boolean
    - `up` integer: Traders whose result on this market was above a cent.
    - `down` integer: Traders whose result was below minus a cent.
    - `strong` object, nullable: Counts for traders with strong records; null under 5 members.
      - `traders` integer
      - `up` integer
      - `down` integer
  - `minTraders` integer
  - `strongRule` object
    - `minDecided` integer
    - `minWinLo` number
    - `minGroup` integer

## Other responses

- `404`: No published stats yet.
- `429`: Rate limited. Per IP 240/min overall and 180/min on the board and entity routes; per account 120/min (anonymous 60/min per IP) on board, entity and market reads. A `retry-after` header may be set.
- `503`: Temporarily unavailable; nothing was charged. Retry shortly.

---

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