Skip to main content
GET
/
gateway
/
v1
/
prediction-market
/
polymarket
/
ranking
Polymarket Market Ranking
curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/ranking
{
  "data": [
    {
      "condition_id": "<string>",
      "notional_volume_usd": 123,
      "open_interest_usd": 123,
      "question": "<string>",
      "status": "<string>",
      "category": "<string>",
      "end_time": 123,
      "polymarket_link": "<string>",
      "subcategory": "<string>",
      "tags": [
        "<string>"
      ]
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
sort_by
enum<string>
default:notional_volume_usd

Sort by last day's notional_volume_usd or open_interest

Available options:
notional_volume_usd,
open_interest
Example:

"notional_volume_usd"

​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
status
enum<string>
default:active

Market status filter: active, finalized, ended, initialized, or closed

Available options:
active,
finalized,
ended,
initialized,
closed
Example:

"active"

​
category
enum<string>

Filter by Surf-curated category

Available options:
crypto,
culture,
early_polymarket_trades,
economics,
financials,
politics,
stem,
sports,
unknown
Example:

"politics"

​
end_before
enum<string>

Filter markets ending within this window from now: 24h, 3d, 7d, 14d, or 30d

Available options:
24h,
3d,
7d,
14d,
30d
Example:

"7d"

​
limit
integer<int64>
default:20

Results per page

Required range: 1 <= x <= 50
Example:

20

​
offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponsePolymarketRankingItem.json"