Polymarket Ranking

GET /gateway/v1/prediction-market/polymarket/ranking

Polymarket Market Ranking

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/ranking

200

{
  "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": "https://example.com/schemas/DataResponsePolymarketRankingItem.json"
}

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

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

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