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.
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 for the number, timestamp and null rules.
GET https://partner-api.bravadotrade.com/v2/polymarket/markets/smart-activity
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bravado","colors":{"primary":"#27d79f","light":"#27d79f","dark":"#27d79f"},"logo":{"light":"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=22dde9c0ee0fdbd8f91ce9429a54b905","dark":"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=baf2da339f0bb40af6bf80b5c8a3d8d2"},"favicon":"https://mintcdn.com/bravado/tvw-FuJ3KxnqXT6G/favicon.png?fit=max\u0026auto=format\u0026n=tvw-FuJ3KxnqXT6G\u0026q=85\u0026s=58549544d9393681903e0f24686da2c4","api":{"mdx":{"server":"https://partner-api.bravadotrade.com"}},"navbar":{"links":[{"href":"mailto:support@bravadotrade.com","label":"Support"},{"href":"https://console.bravadotrade.com/login","label":"Log in"}],"primary":{"type":"button","label":"Create account","href":"https://console.bravadotrade.com/signup"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bravado","hasAudioNarration":false,"actualSubdomain":"bravado","customDomains":["docs.bravadotrade.com"],"gitSource":{"type":"github","owner":"bravado-trade","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae7eb0cd1e13879fd7e22ce","collectionId":"6ef46c3d-88a4-438e-b9ef-1bf6745cea6d","liveDeploymentHistoryId":"6ae7eb0cd1e13879fd7e22ce","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae7ecdee17c0e64392e0048","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Trade API","count":85},{"language":"default","tag":"Data API","count":47},{"language":"default","tag":"Endpoints (OpenAPI)","count":33},{"language":"default","tag":"Trader analytics","count":20},{"language":"default","tag":"Resources","count":20},{"language":"default","tag":"Perps","count":18},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Get Started","count":16},{"language":"default","tag":"Reference","count":14},{"language":"default","tag":"Market Data","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"html.dark{--gray-950:27 27 29;--gray-900:32 32 32;--gray-800:48 48 48;--gray-400:143 143 143}html.dark #background-color{background-color:#1b1b1d!important}html.dark #navbar-transition{background-color:#202020!important;border-color:#303030!important}#navbar .nav-logo{height:36px!important}#content-container .card div:has(>img[src^=\"/logo/\"]),#content-container .card img[src^=\"/logo/\"]{width:44px!important;height:44px!important;max-width:none!important;border-radius:10px}#sidebar{border-right:1px solid #303030}html.dark #sidebar{background:#161617}html.dark body::before{content:\"\";position:fixed;inset:0 auto 0 0;width:max(320px,calc((100vw - 1472px)/2 + 320px));background:#161617;z-index:0;pointer-events:none}html.dark #sidebar div[class*=sticky][class*=h-8]{background-image:linear-gradient(to bottom,#161617 0,rgba(22,22,23,0) 100%)!important}html.dark #sidebar div[class*=\"--scroll-area-fade-size\"]{padding-left:14px;margin-left:-14px}#sidebar a[aria-current=page]{box-shadow:0 0 12px rgba(39,215,159,.25),0 0 3px rgba(39,215,159,.15);border-radius:8px}html.dark #sidebar a[aria-current=page]{background:#2a2a2d}#assistant-entry,#assistant-entry-mobile,.chat-assistant-floating-input,.chat-assistant-sheet{display:none!important}div:has(>#search-bar-entry){flex-grow:1.25}"}],"page":{"pagePath":"api/polymarket/smart-activity","slug":"/api/polymarket/smart-activity","pageMetadata":{"title":"GET /markets/smart-activity: Smart-Activity Markets","sidebarTitle":"/markets/smart-activity","api":"GET /v2/polymarket/markets/smart-activity","description":"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.","href":"/api/polymarket/smart-activity"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[`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 `,_jsx(_components.a,{href:`/authentication-examples`,children:`request signing examples`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Returns per-market aggregates computed over the `,_jsx(_components.strong,{children:`smart-money cohort`}),` — a fixed, all-time cohort of wallets selected by PnL / volume / trade floors. One row per market. Fixed to Polymarket (no `,_jsx(_components.code,{children:`venue`}),` parameter). See `,_jsx(_components.a,{href:`/api/polymarket/overview`,children:`response conventions`}),` for the number, timestamp and null rules.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET https://partner-api.bravadotrade.com/v2/polymarket/markets/smart-activity`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`sort_by`,type:`string`,default:`smart_volume`,id:`param-sort-by`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`smart_volume`}),`, `,_jsx(_components.code,{children:`smart_wallet_count`}),`, `,_jsx(_components.code,{children:`smart_realized_pnl`}),`, `,_jsx(_components.code,{children:`smart_total_pnl`}),`, `,_jsx(_components.code,{children:`avg_smart_roi`}),`, `,_jsx(_components.code,{children:`avg_smart_win_rate`}),`, `,_jsx(_components.code,{children:`net_buyers_pct`}),`.`]})}),`\n`,_jsx(ParamField,{query:`order`,type:`string`,id:`param-order`,children:_jsxs(_components.p,{children:[`Sort direction: `,_jsx(_components.code,{children:`asc`}),` or `,_jsx(_components.code,{children:`desc`}),`.`]})}),`\n`,_jsx(ParamField,{query:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Market status filter (e.g. `,_jsx(_components.code,{children:`open`}),`).`]})}),`\n`,_jsx(ParamField,{query:`min_total_pnl`,type:`string`,id:`param-min-total-pnl`,children:_jsxs(_components.p,{children:[`Cohort floor, USD. Must equal the served cohort’s value (echoed back under `,_jsx(_components.code,{children:`cohort`}),`).`]})}),`\n`,_jsx(ParamField,{query:`min_volume`,type:`string`,id:`param-min-volume`,children:_jsx(_components.p,{children:`Cohort floor, USD. Must equal the served cohort’s value.`})}),`\n`,_jsx(ParamField,{query:`min_trades`,type:`integer`,id:`param-min-trades`,children:_jsx(_components.p,{children:`Cohort floor. Must equal the served cohort’s value.`})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Rows per page, up to 200.`})}),`\n`,_jsx(ParamField,{query:`pagination_key`,type:`string`,id:`param-pagination-key`,children:_jsxs(_components.p,{children:[`Opaque cursor from the previous page’s `,_jsx(_components.code,{children:`pagination.pagination_key`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`markets`,type:`array`,id:`param-markets`,children:_jsxs(Expandable,{title:`market`,children:[_jsxs(ResponseField,{name:`condition_id`,type:`string`,id:`param-condition-id`,children:[`Market condition id; `,_jsx(_components.code,{children:`null`}),` when unknown.`]}),_jsxs(ResponseField,{name:`title`,type:`string`,id:`param-title`,children:[`Market title; `,_jsx(_components.code,{children:`null`}),` when unknown.`]}),_jsxs(ResponseField,{name:`market_slug`,type:`string`,id:`param-market-slug`,children:[`Market slug; `,_jsx(_components.code,{children:`null`}),` when unknown.`]}),_jsx(ResponseField,{name:`smart_wallet_count`,type:`integer`,id:`param-smart-wallet-count`,children:`Smart-cohort wallets active in the market.`}),_jsx(ResponseField,{name:`smart_volume`,type:`string`,id:`param-smart-volume`,children:`Cohort volume, USD decimal string.`}),_jsx(ResponseField,{name:`smart_realized_pnl`,type:`string`,id:`param-smart-realized-pnl`,children:`Cohort realized PnL, USD decimal string.`}),_jsx(ResponseField,{name:`smart_total_pnl`,type:`string`,id:`param-smart-total-pnl`,children:`Cohort total PnL, USD decimal string.`}),_jsxs(ResponseField,{name:`avg_smart_roi`,type:`string`,id:`param-avg-smart-roi`,children:[`Average cohort ROI, `,_jsx(_components.code,{children:`0`}),`–`,_jsx(_components.code,{children:`1`}),` decimal; `,_jsx(_components.code,{children:`null`}),` when uncovered.`]}),_jsxs(ResponseField,{name:`avg_smart_win_rate`,type:`string`,id:`param-avg-smart-win-rate`,children:[`Average cohort win rate, `,_jsx(_components.code,{children:`0`}),`–`,_jsx(_components.code,{children:`1`}),` decimal; `,_jsx(_components.code,{children:`null`}),` when uncovered.`]}),_jsxs(ResponseField,{name:`net_buyers_pct`,type:`string`,id:`param-net-buyers-pct`,children:[`Net buying share, `,_jsx(_components.code,{children:`0`}),`–`,_jsx(_components.code,{children:`1`}),` decimal; `,_jsx(_components.code,{children:`null`}),` when unknown.`]}),_jsx(ResponseField,{name:`total_pnl_known`,type:`boolean`,id:`param-total-pnl-known`,children:`Whether every cohort wallet’s total PnL was resolvable for this market.`}),_jsx(ResponseField,{name:`smart_total_pnl_unknown_wallets`,type:`integer`,id:`param-smart-total-pnl-unknown-wallets`,children:`Cohort wallets whose total PnL could not be resolved (the rest still aggregate).`}),_jsxs(ResponseField,{name:`roi_covered_wallets`,type:`integer`,id:`param-roi-covered-wallets`,children:[`Cohort wallets whose ROI was computable (the denominator behind `,_jsx(_components.code,{children:`avg_smart_roi`}),`).`]})]})}),`\n`,_jsx(ResponseField,{name:`pagination`,type:`object`,id:`param-pagination`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`limit`}),`, `,_jsx(_components.code,{children:`count`}),`, `,_jsx(_components.code,{children:`has_more`}),` (boolean), `,_jsx(_components.code,{children:`pagination_key`}),` (string or `,_jsx(_components.code,{children:`null`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`computed_at`,type:`integer`,id:`param-computed-at`,children:`Unix seconds the snapshot was computed.`}),`\n`,_jsx(ResponseField,{name:`cohort`,type:`object`,id:`param-cohort`,children:_jsxs(_components.p,{children:[`The cohort these aggregates are over, echoed back: `,_jsx(_components.code,{children:`window`}),`, `,_jsx(_components.code,{children:`min_total_pnl`}),`, `,_jsx(_components.code,{children:`min_volume`}),`, `,_jsx(_components.code,{children:`min_trades`}),`, `,_jsx(_components.code,{children:`cohort_version`}),`, `,_jsx(_components.code,{children:`excluded_other_cohort_rows`}),`, `,_jsx(_components.code,{children:`roi_basis`}),`. Pass the three `,_jsx(_components.code,{children:`min_*`}),` values back verbatim to page through a stable cohort.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GET /markets/smart-activity: Smart-Activity Markets","sidebarTitle":"/markets/smart-activity","api":"GET /v2/polymarket/markets/smart-activity","description":"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.","href":"/api/polymarket/smart-activity"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{},"endpoint":{"title":"GET /markets/smart-activity: Smart-Activity Markets","path":"/v2/polymarket/markets/smart-activity","servers":[{"url":"https://partner-api.bravadotrade.com"}],"method":"get","request":{"security":[],"parameters":{"query":{"sort_by":{"schema":[{"type":"string","description":"One of `smart_volume` , `smart_wallet_count` , `smart_realized_pnl` , `smart_total_pnl` , `avg_smart_roi` , `avg_smart_win_rate` , `net_buyers_pct` ."}]},"order":{"schema":[{"type":"string","description":"Sort direction: `asc` or `desc` ."}]},"status":{"schema":[{"type":"string","description":"Market status filter (e.g. `open` )."}]},"min_total_pnl":{"schema":[{"type":"string","description":"Cohort floor, USD. Must equal the served cohort’s value (echoed back under `cohort` )."}]},"min_volume":{"schema":[{"type":"string","description":"Cohort floor, USD. Must equal the served cohort’s value."}]},"min_trades":{"schema":[{"type":"integer","description":"Cohort floor. Must equal the served cohort’s value."}]},"limit":{"schema":[{"type":"integer","description":"Rows per page, up to 200."}]},"pagination_key":{"schema":[{"type":"string","description":"Opaque cursor from the previous page’s `pagination.pagination_key` ."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"markets":[{"type":"array","items":[{"type":"object","properties":{"condition_id":[{"type":"string","description":"Market condition id; `null` when unknown."}],"title":[{"type":"string","description":"Market title; `null` when unknown."}],"market_slug":[{"type":"string","description":"Market slug; `null` when unknown."}],"smart_wallet_count":[{"type":"integer","description":"Smart-cohort wallets active in the market."}],"smart_volume":[{"type":"string","description":"Cohort volume, USD decimal string."}],"smart_realized_pnl":[{"type":"string","description":"Cohort realized PnL, USD decimal string."}],"smart_total_pnl":[{"type":"string","description":"Cohort total PnL, USD decimal string."}],"avg_smart_roi":[{"type":"string","description":"Average cohort ROI, `0` – `1` decimal; `null` when uncovered."}],"avg_smart_win_rate":[{"type":"string","description":"Average cohort win rate, `0` – `1` decimal; `null` when uncovered."}],"net_buyers_pct":[{"type":"string","description":"Net buying share, `0` – `1` decimal; `null` when unknown."}],"total_pnl_known":[{"type":"boolean","description":"Whether every cohort wallet’s total PnL was resolvable for this market."}],"smart_total_pnl_unknown_wallets":[{"type":"integer","description":"Cohort wallets whose total PnL could not be resolved (the rest still aggregate)."}],"roi_covered_wallets":[{"type":"integer","description":"Cohort wallets whose ROI was computable (the denominator behind `avg_smart_roi` )."}]}}]}],"pagination":[{"type":"object","properties":{},"description":"`limit` , `count` , `has_more` (boolean), `pagination_key` (string or `null` )."}],"computed_at":[{"type":"integer","description":"Unix seconds the snapshot was computed."}],"cohort":[{"type":"object","properties":{},"description":"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."}]}}],"examples":{"example":{"value":{"markets":[{"condition_id":"\u003cstring>","title":"\u003cstring>","market_slug":"\u003cstring>","smart_wallet_count":123,"smart_volume":"\u003cstring>","smart_realized_pnl":"\u003cstring>","smart_total_pnl":"\u003cstring>","avg_smart_roi":"\u003cstring>","avg_smart_win_rate":"\u003cstring>","net_buyers_pct":"\u003cstring>","total_pnl_known":true,"smart_total_pnl_unknown_wallets":123,"roi_covered_wallets":123}],"pagination":{},"computed_at":123,"cohort":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"bravado","siteName":"Bravado","title":"GET /markets/smart-activity: Smart-Activity Markets - Bravado","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T01:52:36.784Z","originalFileLocation":"api/polymarket/smart-activity.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bravado\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GET /markets/smart-activity: Smart-Activity Markets - Bravado\">\u003cmeta data-mint-head property=\"og:description\" content=\"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bravado\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bravadotrade.com/api/polymarket/smart-activity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bravado.mintlify.app/_mintlify/api/og/v2?division=Polymarket+analytics\u0026amp;title=GET+%2Fmarkets%2Fsmart-activity%3A+Smart-Activity+Markets\u0026amp;description=Per-market+aggregates+over+the+smart-money+cohort+on+Polymarket%3A+volume%2C+PnL%2C+ROI%2C+win+rate+and+net+buying.+Cursor-paginated.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=6cf3809cc28fd4f864ce217e08451a16984cbcc67695a761a4f1d12b3643a876\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GET /markets/smart-activity: Smart-Activity Markets - Bravado\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bravado.mintlify.app/_mintlify/api/og/v2?division=Polymarket+analytics\u0026amp;title=GET+%2Fmarkets%2Fsmart-activity%3A+Smart-Activity+Markets\u0026amp;description=Per-market+aggregates+over+the+smart-money+cohort+on+Polymarket%3A+volume%2C+PnL%2C+ROI%2C+win+rate+and+net+buying.+Cursor-paginated.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=6cf3809cc28fd4f864ce217e08451a16984cbcc67695a761a4f1d12b3643a876\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bravado\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#27d79f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bravadotrade.com/api/polymarket/smart-activity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/polymarket/smart-activity.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bravadotrade.com/#organization\",\"name\":\"Bravado\",\"url\":\"https://docs.bravadotrade.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=22dde9c0ee0fdbd8f91ce9429a54b905\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bravadotrade.com#website\",\"name\":\"Bravado\",\"url\":\"https://docs.bravadotrade.com\",\"publisher\":{\"@id\":\"https://docs.bravadotrade.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity#webpage\",\"url\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity\",\"name\":\"GET /markets/smart-activity: Smart-Activity Markets\",\"description\":\"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\",\"dateModified\":\"2026-11-02T01:52:36.784Z\",\"isPartOf\":{\"@id\":\"https://docs.bravadotrade.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Polymarket analytics\",\"item\":\"https://docs.bravadotrade.com/api/polymarket/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /markets/smart-activity: Smart-Activity Markets\",\"item\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity#apireference\",\"headline\":\"GET /markets/smart-activity: Smart-Activity Markets\",\"name\":\"GET /markets/smart-activity: Smart-Activity Markets\",\"description\":\"Per-market aggregates over the smart-money cohort on Polymarket: volume, PnL, ROI, win rate and net buying. Cursor-paginated.\",\"url\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bravadotrade.com/api/polymarket/smart-activity#webpage\"},\"dateModified\":\"2026-11-02T01:52:36.784Z\",\"publisher\":{\"@id\":\"https://docs.bravadotrade.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bravadotrade.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bravado\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bravado","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Data API","groups":[{"group":"Data API","pages":[{"title":"Data API: Trader Analytics and Combos Data","sidebarTitle":"Overview","icon":{"name":"chart-line","library":"lucide"},"href":"/products/data-api"}]},{"group":"Kalshi market data","pages":[{"title":"Kalshi native market data","sidebarTitle":"Kalshi current data","href":"/api/market-data/kalshi-native"},{"title":"Kalshi current liquidity","sidebarTitle":"Kalshi liquidity","href":"/api/market-data/kalshi-liquidity"},{"title":"Captured Kalshi order-book history","sidebarTitle":"Kalshi order-book history","href":"/api/market-data/kalshi-history"}]},{"group":"Trader analytics","pages":[{"title":"Data API: Trader Analytics Reference","sidebarTitle":"Overview","icon":{"name":"book-open","library":"lucide"},"href":"/api/analytics/overview"},{"title":"GET /healthz: Data API Liveness Probe","sidebarTitle":"/healthz","api":"GET /trader-analytics/healthz","href":"/api/analytics/healthz"},{"title":"GET /leaderboard: PnL Leaderboard","sidebarTitle":"/leaderboard","api":"GET /trader-analytics/leaderboard","href":"/api/analytics/leaderboard"},{"title":"GET /leaderboard/volume: Polymarket Volume Leaderboard","sidebarTitle":"/leaderboard/volume","api":"GET /trader-analytics/leaderboard/volume","href":"/api/analytics/leaderboard-volume"},{"title":"GET /traders/{address}: Trader Profile Summary","sidebarTitle":"/traders/{address}","api":"GET /trader-analytics/traders/{address}","href":"/api/analytics/trader"},{"title":"GET /traders/{address}/pnl: Cumulative PnL Time Series","sidebarTitle":"/traders/{address}/pnl","api":"GET /trader-analytics/traders/{address}/pnl","href":"/api/analytics/trader-pnl"},{"title":"GET /traders/{address}/positions: All Positions","sidebarTitle":"/traders/{address}/positions","api":"GET /trader-analytics/traders/{address}/positions","href":"/api/analytics/trader-positions"},{"title":"GET /traders/{address}/positions/active: Open Positions","sidebarTitle":"/traders/{address}/positions/active","api":"GET /trader-analytics/traders/{address}/positions/active","href":"/api/analytics/trader-positions-active"},{"title":"GET /traders/{address}/positions/closed: Closed Positions","sidebarTitle":"/traders/{address}/positions/closed","api":"GET /trader-analytics/traders/{address}/positions/closed","href":"/api/analytics/trader-positions-closed"},{"title":"GET /positions: Positions Across All Wallets","sidebarTitle":"/positions","api":"GET /trader-analytics/positions","href":"/api/analytics/positions"},{"title":"GET /traders/{address}/trades: Trade Log","sidebarTitle":"/traders/{address}/trades","api":"GET /trader-analytics/traders/{address}/trades","href":"/api/analytics/trader-trades"},{"title":"GET /traders/{address}/categories: Per-Category Breakdown","sidebarTitle":"/traders/{address}/categories","api":"GET /trader-analytics/traders/{address}/categories","href":"/api/analytics/trader-categories"},{"title":"GET /traders/{address}/usdc-balance: On-Chain USDC Balance","sidebarTitle":"/traders/{address}/usdc-balance","api":"GET /trader-analytics/traders/{address}/usdc-balance","href":"/api/analytics/trader-usdc-balance"},{"title":"GET /traders/{address}/statements: Full PMWAS Statement","sidebarTitle":"/traders/{address}/statements","api":"GET /trader-analytics/traders/{address}/statements","href":"/api/analytics/trader-statements"},{"title":"GET /traders/{address}/statements/r1: R1 Dispositions","sidebarTitle":"/traders/{address}/statements/r1","api":"GET /trader-analytics/traders/{address}/statements/r1","href":"/api/analytics/trader-statements-r1"},{"title":"GET /traders/{address}/metrics: Performance Metrics (R5/R6/R7)","sidebarTitle":"/traders/{address}/metrics","api":"GET /trader-analytics/traders/{address}/metrics","href":"/api/analytics/trader-metrics"},{"title":"GET /traders/{address}/reconciliation: R8 Certificate","sidebarTitle":"/traders/{address}/reconciliation","api":"GET /trader-analytics/traders/{address}/reconciliation","href":"/api/analytics/trader-reconciliation"},{"title":"GET /traders/{address}/tax-report: Per-Year Tax Summary","sidebarTitle":"/traders/{address}/tax-report","api":"GET /trader-analytics/traders/{address}/tax-report","href":"/api/analytics/trader-tax-report"},{"title":"GET /trades: Trade Log by Query Parameter","sidebarTitle":"/trades","api":"GET /trader-analytics/trades","href":"/api/analytics/trades"},{"title":"GET /entity/{owner}: Multi-Wallet Entity Rollup","sidebarTitle":"/entity/{owner}","api":"GET /trader-analytics/entity/{owner}","href":"/api/analytics/entity"}]},{"group":"Polymarket analytics","pages":[{"title":"Polymarket Analytics","sidebarTitle":"Overview","href":"/api/polymarket/overview"},{"title":"GET /leaderboard: Wallet Leaderboard","sidebarTitle":"/leaderboard","api":"GET /v2/polymarket/leaderboard","href":"/api/polymarket/leaderboard"},{"title":"GET /wallet/{wallet}: Wallet Profile","sidebarTitle":"/wallet/{wallet}","api":"GET /v2/polymarket/wallet/{wallet}","href":"/api/polymarket/wallet"},{"title":"GET /wallets/profiles: Batch Wallet Profiles","sidebarTitle":"/wallets/profiles","api":"GET /v2/polymarket/wallets/profiles","description":"The wallet-profile metric set for a batch of Polymarket wallets in one call.","href":"/api/polymarket/wallets-profiles"},{"title":"GET /markets/smart-activity: Smart-Activity Markets","sidebarTitle":"/markets/smart-activity","api":"GET /v2/polymarket/markets/smart-activity","href":"/api/polymarket/smart-activity"}]},{"group":"Combos Data","pages":[{"title":"Combos Data API: Polymarket Combos Market Data","sidebarTitle":"Overview","description":"Read-only, market-wide data on Polymarket Combos: every multi-leg settlement on the venue, each combo's legs mapped to its underlying markets, aggregate stats and a combo trader leaderboard.","icon":{"name":"layers","library":"lucide"},"href":"/api/combos-data/overview"},{"title":"GET /v2/data/combos: List Combos","sidebarTitle":"/combos","api":"GET /v2/data/combos","href":"/api/combos-data/list"},{"title":"GET /v2/data/combos/trades: Combo Trades","sidebarTitle":"/combos/trades","api":"GET /v2/data/combos/trades","href":"/api/combos-data/trades"},{"title":"GET /v2/data/combos/{combo_id}: Combo Detail","sidebarTitle":"/combos/{combo_id}","api":"GET /v2/data/combos/{combo_id}","href":"/api/combos-data/combo"},{"title":"GET /v2/data/combos/stats: Combo Stats","sidebarTitle":"/combos/stats","api":"GET /v2/data/combos/stats","href":"/api/combos-data/stats"},{"title":"GET /v2/data/combos/leaderboard: Combo Traders","sidebarTitle":"/combos/leaderboard","api":"GET /v2/data/combos/leaderboard","href":"/api/combos-data/leaderboard"}]},{"group":"Perps data","pages":[{"title":"Perps Data: Polymarket Perpetual-Futures Market Data","sidebarTitle":"Overview","icon":{"name":"trending-up","library":"lucide"},"href":"/products/perps-data"},{"title":"GET /perps/funding/history: Funding History","sidebarTitle":"GET /funding/history","api":"GET /perps/funding/history","href":"/api/perps-data/funding-history"},{"title":"GET /perps/funding/compare: Funding Comparison","sidebarTitle":"GET /funding/compare","api":"GET /perps/funding/compare","href":"/api/perps-data/funding-compare"},{"title":"GET /perps/oi/history: Open-Interest History","sidebarTitle":"GET /oi/history","api":"GET /perps/oi/history","href":"/api/perps-data/oi-history"},{"title":"GET /perps/basis: Mark, Index and Basis","sidebarTitle":"GET /basis","api":"GET /perps/basis","href":"/api/perps-data/basis"},{"title":"GET /perps/skew: Long/Short Account Skew","sidebarTitle":"GET /skew","api":"GET /perps/skew","href":"/api/perps-data/skew"},{"title":"GET /perps/liquidations: Liquidation History","sidebarTitle":"GET /liquidations","api":"GET /perps/liquidations","href":"/api/perps-data/liquidations"}]},{"group":"By venue","pages":[{"title":"Data API on Polymarket","sidebarTitle":"Data API","icon":{"name":"chart-line","library":"lucide"},"href":"/markets/polymarket/data-api"},{"title":"Data API on Predict.fun","sidebarTitle":"Data API","icon":{"name":"chart-line","library":"lucide"},"href":"/markets/predict-fun/data-api"}]},{"group":"Guides","pages":[{"title":"How to Build a Polymarket PnL Leaderboard","sidebarTitle":"Build a PnL leaderboard","icon":{"name":"trophy","library":"lucide"},"href":"/guides/pnl-leaderboard"},{"title":"How to Generate a US Tax Statement for Polymarket Trading","sidebarTitle":"Generate a tax statement","icon":{"name":"receipt","library":"lucide"},"href":"/guides/us-tax-statement"}]}]},{"tab":"Market Data","pages":[{"title":"Market Data","href":"/products/market-data"}]},{"tab":"Trade API","pages":[{"title":"Trade API","href":"/products/trade-api"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/products/mcp-server"}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/reference/errors"}]}]},"basePath":"","title":"GET /markets/smart-activity: Smart-Activity Markets - Bravado","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js"]}