---
title: "Api Markets Search"
method: GET
path: "/api/v2/markets/search"
---

# Api Markets Search

`GET /api/v2/markets/search`

## Request

- Base URL: `https://orcalayer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://orcalayer.com/api/v2/markets/search`
- Auth: none declared

Search / browse markets with server-side filters.

Filters (all SQL-side so `total` reflects full match set, not just page):
    q           — text search (also accepts Polymarket URL/slug)
    category    — All | Crypto | Geopolitics | Sports | Politics | Economics | Tech/AI
    min_volume  — minimum volume USD
    min_whales  — minimum total smart whales (yes+no)
    min_days    — minimum days until end_date
    max_days    — maximum days until end_date
    limit       — page size (default 50, max 200)
    offset      — pagination offset

Returns: {markets, total, limit, offset, _elapsed_ms}

## Query parameters

- `q` string
- `category` string
- `limit` integer
- `offset` integer
- `min_volume` number
- `min_whales` integer
- `min_days` integer
- `max_days` integer
- `price_min` integer
- `price_max` integer
- `window_hours` integer
- `created_within_days` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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