> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bravadotrade.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /markets/smart-activity: Smart-Activity Markets

> Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.

> [!NOTE]
>
> Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md).

Returns per-market aggregates computed over the **smart-money cohort** — a fixed, all-time cohort of wallets selected by PnL / volume / trade floors. One row per market. Fixed to Polymarket (no `venue` parameter). See [response conventions](https://docs.bravadotrade.com/api/polymarket/overview.md) for the number, timestamp and null rules.

```text theme={null}
GET https://partner-api.bravadotrade.com/v2/polymarket/markets/smart-activity
```

### Query Parameters

**sort\_by** `string` (default: smart\_volume)

One of `smart_volume`, `smart_wallet_count`, `smart_realized_pnl`, `smart_total_pnl`, `avg_smart_roi`, `avg_smart_win_rate`, `net_buyers_pct`.

**order** `string`

Sort direction: `asc` or `desc`.

**status** `string`

Market status filter (e.g. `open`).

**min\_total\_pnl** `string`

Cohort floor, USD. Must equal the served cohort's value (echoed back under `cohort`).

**min\_volume** `string`

Cohort floor, USD. Must equal the served cohort's value.

**min\_trades** `integer`

Cohort floor. Must equal the served cohort's value.

**limit** `integer` (default: 50)

Rows per page, up to 200.

**pagination\_key** `string`

Opaque cursor from the previous page's `pagination.pagination_key`.

### Response

**markets** `array`

**market**

**condition\_id** `string`

Market condition id; `null` when unknown.

**title** `string`

Market title; `null` when unknown.

**market\_slug** `string`

Market slug; `null` when unknown.

**smart\_wallet\_count** `integer`

Smart-cohort wallets active in the market.

**smart\_volume** `string`

Cohort volume, USD decimal string.

**smart\_realized\_pnl** `string`

Cohort realized PnL, USD decimal string.

**smart\_total\_pnl** `string`

Cohort total PnL, USD decimal string.

**avg\_smart\_roi** `string`

Average cohort ROI, `0`–`1` decimal; `null` when uncovered.

**avg\_smart\_win\_rate** `string`

Average cohort win rate, `0`–`1` decimal; `null` when uncovered.

**net\_buyers\_pct** `string`

Net buying share, `0`–`1` decimal; `null` when unknown.

**total\_pnl\_known** `boolean`

Whether every cohort wallet's total PnL was resolvable for this market.

**smart\_total\_pnl\_unknown\_wallets** `integer`

Cohort wallets whose total PnL could not be resolved (the rest still aggregate).

**roi\_covered\_wallets** `integer`

Cohort wallets whose ROI was computable (the denominator behind `avg_smart_roi`).

**pagination** `object`

`limit`, `count`, `has_more` (boolean), `pagination_key` (string or `null`).

**computed\_at** `integer`

Unix seconds the snapshot was computed.

**cohort** `object`

The cohort these aggregates are over, echoed back: `window`, `min_total_pnl`, `min_volume`, `min_trades`, `cohort_version`, `excluded_other_cohort_rows`, `roi_basis`. Pass the three `min_*` values back verbatim to page through a stable cohort.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.