---
title: "Polymarket Smart Money"
method: GET
path: "/gateway/v1/prediction-market/polymarket/smart-money"
tags: ["Prediction Market"]
---

# Polymarket Smart Money

`GET /gateway/v1/prediction-market/polymarket/smart-money`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/smart-money`
- Auth: HTTP bearer

Smart wallet analytics for Polymarket markets.

view=positioning (default): Aggregate smart wallet direction per market — net bullish/bearish signal and conviction.
view=trades: Individual $10K+ trades with wallet address, amount, outcome, price, and wallet age.

**Data refresh:** ~5 minutes

## Query parameters

- `view` 'positioning' | 'trades': positioning = aggregate smart wallet direction per market; trades = individual $10K+ trades with wallet metadata
- `condition_id` string: Filter to a specific market (omit to browse all)
- `category` 'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports': Filter by category
- `direction` 'bullish' | 'bearish' | 'neutral': Filter by net smart money direction (only for view=positioning)
- `whale_tier` 'whale' | 'large' | 'mega': Trade size tier filter (only for view=trades)
- `from` string: Start time as Unix seconds or date string (only for view=trades)
- `to` string: End time as Unix seconds or date string (only for view=trades)
- `sort_by` 'smart_wallets_involved' | 'smart_buy_volume_usd' | 'smart_sell_volume_usd' | 'amount_usd' | 'block_time': Sort field
- `order` 'asc' | 'desc': Sort direction
- `limit` integer: Results per page
- `offset` integer: Pagination offset

## Response `200`

OK

- DataResponseInterface
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` unknown[], nullable, required
    - unknown
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)