Skip to main content
GET
/
polymarket
/
search
Search events, markets, traders, and builders
curl --request GET \
  --url https://api.struct.to/v1/polymarket/search
{
  "events": [
    {
      "id": "",
      "event_slug": null,
      "title": null,
      "ticker": null,
      "description": null,
      "resolution_source": null,
      "category": null,
      "image_url": null,
      "market_count": 0,
      "created_time": null,
      "closed_time": null,
      "start_time": null,
      "end_time": null,
      "neg_risk": false,
      "neg_risk_market_id": null,
      "game_status": null,
      "show_market_images": false,
      "status": null,
      "metrics": {
        "1m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "5m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "30m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "1h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "6h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "24h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "7d": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "30d": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "lifetime": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        }
      },
      "tags": [
        {
          "id": "",
          "label": "",
          "slug": null,
          "volume_usd": 123,
          "shares_volume": 123,
          "builder_usd_volume": 123,
          "builder_shares_volume": 123,
          "txn_count": 123,
          "builder_txn_count": 123,
          "unique_traders": 123,
          "unique_makers": 123,
          "unique_takers": 123,
          "unique_builder_traders": 123,
          "fees_usd": 123,
          "builder_fees_usd": 123
        }
      ],
      "markets": [
        {
          "condition_id": "",
          "id": null,
          "title": null,
          "question": "",
          "market_slug": "",
          "status": "",
          "created_time": null,
          "end_time": null,
          "volume": null,
          "liquidity_usd": null,
          "volume_24hr": null,
          "image_url": null,
          "market_maker_address": null,
          "creator": null,
          "category": null,
          "accepting_orders": null,
          "uma_resolution_status": null,
          "clob_rewards": [
            {
              "id": "<string>",
              "condition_id": "<string>",
              "asset_address": "<string>",
              "rewards_amount": 123,
              "rewards_daily_rate": 123,
              "start_date": "<string>",
              "end_date": "<string>",
              "rewards_max_spread": 123,
              "rewards_min_size": 123,
              "native_daily_rate": 123,
              "sponsored_daily_rate": 123,
              "total_daily_rate": 123,
              "sponsors_count": 123
            }
          ],
          "outcomes": [
            {
              "name": "<string>",
              "price": 123,
              "position_id": "<string>",
              "outcome_index": 123
            }
          ],
          "winning_outcome": {
            "name": "<string>",
            "price": 123,
            "position_id": "<string>",
            "outcome_index": 123
          }
        }
      ],
      "series": {
        "id": "",
        "slug": null,
        "ticker": null,
        "title": null,
        "description": null,
        "series_type": null,
        "recurrence": null,
        "layout": null,
        "image_url": null,
        "icon_url": null,
        "active": false,
        "closed": false,
        "archived": false,
        "featured": false,
        "restricted": false,
        "pyth_token_id": null,
        "cg_asset_name": null,
        "start_date": null,
        "event_count": 0
      }
    }
  ],
  "events_pagination": {
    "has_more": true,
    "pagination_key": "<string>"
  },
  "markets": [
    {
      "condition_id": "<string>",
      "status": "<string>",
      "id": "<string>",
      "market_slug": "<string>",
      "question": "<string>",
      "title": "<string>",
      "description": "<string>",
      "image_url": "<string>",
      "oracle": "<string>",
      "created_time": 123,
      "start_time": 123,
      "game_start_time": 123,
      "closed_time": 123,
      "end_time": 123,
      "accepting_orders": true,
      "uma_resolution_status": "<string>",
      "is_neg_risk": true,
      "market_maker_address": "<string>",
      "creator": "<string>",
      "category": "<string>",
      "volume_usd": 123,
      "liquidity_usd": 123,
      "highest_probability": 123,
      "total_holders": 123,
      "total_daily_rate": 123,
      "winning_outcome": {
        "name": "",
        "price": null,
        "position_id": null,
        "outcome_index": null,
        "latest_block": null,
        "latest_confirmed_at": null
      },
      "outcomes": [
        {
          "name": "",
          "price": null,
          "position_id": null,
          "outcome_index": null,
          "latest_block": null,
          "latest_confirmed_at": null
        }
      ],
      "clob_rewards": [
        {
          "id": "<string>",
          "condition_id": "<string>",
          "asset_address": "<string>",
          "rewards_amount": 123,
          "rewards_daily_rate": 123,
          "start_date": "<string>",
          "end_date": "<string>",
          "rewards_max_spread": 123,
          "rewards_min_size": 123,
          "native_daily_rate": 123,
          "sponsored_daily_rate": 123,
          "total_daily_rate": 123,
          "sponsors_count": 123
        }
      ],
      "tags": [
        "<string>"
      ],
      "event_slug": "<string>",
      "resolution_source": "<string>",
      "metrics": {
        "1m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "5m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "30m": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "1h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "6h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "24h": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "7d": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "30d": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        },
        "lifetime": {
          "volume": 0,
          "shares_volume": 0,
          "builder_usd_volume": 0,
          "builder_shares_volume": 0,
          "fees": 0,
          "builder_fees": 0,
          "txns": 0,
          "builder_txns": 0,
          "unique_traders": 0,
          "unique_makers": 0,
          "unique_takers": 0,
          "unique_builder_traders": 0
        }
      },
      "relevance_score": 123
    }
  ],
  "markets_pagination": {
    "has_more": true,
    "pagination_key": "<string>"
  },
  "traders": [
    {
      "address": "<string>",
      "name": "<string>",
      "pseudonym": "<string>",
      "profile_image": "<string>",
      "x_username": "<string>",
      "verified_badge": true,
      "pnl": "<unknown>"
    }
  ],
  "traders_pagination": {
    "has_more": true,
    "pagination_key": "<string>"
  },
  "builders": [
    {
      "builder_code": "<string>",
      "name": "<string>",
      "website": "<string>",
      "twitter": "<string>",
      "icon_url": "<string>",
      "description": "<string>"
    }
  ],
  "builders_pagination": {
    "has_more": true,
    "pagination_key": "<string>"
  }
}

Query Parameters

​
q
string
required

Search query (min 2 characters). Slug-shaped values match event/market slugs. Prefix with 0x for exact wallet address lookup.

​
type
string

Comma-separated categories to search: events, markets, traders, builders (default: all four, 1 credit per type). Example: type=markets,builders

​
include_pnl
boolean

Include lifetime PnL summary for each trader (default: false, +1 credit)

​
sort_by
enum<string>

Sort field applied to both events and markets (default: volume). Fields marked events-only or markets-only fall back to volume on the other category. Combined sort options valid for both events and markets in search

Available options:
volume,
txns,
unique_traders,
relevance,
title,
creation_date,
start_date,
end_date,
liquidity,
holders,
end_time,
start_time,
created_time
​
sort_dir
enum<string>

Sort direction (default: desc)

Available options:
asc,
desc
​
timeframe
enum<string>

Metrics timeframe used for volume/txns/unique_traders sort (default: 24h)

Available options:
1m,
5m,
30m,
1h,
6h,
24h,
7d,
30d,
lifetime
​
limit
integer<int32>

Results limit per category (default: 10, max: 250)

​
events_pagination_key
string

Cursor for the next page of events, obtained from previous response's events_pagination.pagination_key

​
markets_pagination_key
string

Cursor for the next page of markets, obtained from previous response's markets_pagination.pagination_key

​
traders_pagination_key
string

Cursor for the next page of traders, obtained from previous response's traders_pagination.pagination_key

​
builders_pagination_key
string

Cursor for the next page of builders, obtained from previous response's builders_pagination.pagination_key

Response

Search results. Only requested categories (via type) are included in the response.

​
events
object[] | null
​
events_pagination
object

Pagination metadata to include in API responses

​
markets
object[] | null
​
markets_pagination
object

Pagination metadata to include in API responses

​
traders
object[] | null
​
traders_pagination
object

Pagination metadata to include in API responses

​
builders
object[] | null
​
builders_pagination
object

Pagination metadata to include in API responses

Last modified on June 17, 2026