Markets by Category

Browse markets by category with pagination and event counts.

GET /v2/markets/{category}

Markets by category

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/markets/{category} \
  --header 'x-api-key: <api-key>'

{
  "category": "crypto",
  "counts": {
    "all": 260,
    "fiveM": 7,
    "fifteenM": 7,
    "pre-market": 112,
    "etf": 2,
    "hourly": 9,
    "fourhour": 7,
    "daily": 11,
    "weekly": 64,
    "monthly": 23,
    "yearly": 22,
    "bitcoin": 35,
    "ethereum": 21,
    "solana": 12,
    "xrp": 11,
    "dogecoin": 6,
    "bnb": 6,
    "microstrategy": 8
  },
  "events": [
    {
      "id": "273112",
      "slug": "bitcoin-above-on-april-23",
      "title": "Bitcoin above ___ on April 23?",
      "image": "https://...",
      "volume": 12345678,
      "volume24hr": 5678901,
      "liquidity": 1234567,
      "openInterest": 890123,
      "startDate": "2025-04-22T00:00:00Z",
      "endDate": "2025-04-23T23:59:59Z",
      "active": true,
      "closed": false,
      "new": false,
      "featured": true,
      "competitive": true,
      "commentCount": 42,
      "tags": ["Crypto", "Bitcoin"]
    }
  ],
  "limit": 50,
  "offset": 0
}

Returns markets for a specific category, sorted by 24h volume. Supports pagination with limit and offset.

category · string · required

Category slug. One of:

Category	Slug
Crypto	crypto
Politics	politics
Sports	sports
Finance	finance
Economy	economy
Tech	tech
Pop Culture	pop-culture
Geopolitics	geopolitics
Weather	weather
Iran	iran
Elections	elections
Mentions	mentions
Esports	esports

limit · number · default: "20"

Number of events to return. Min 1, max 100.

offset · number · default: "0"

Pagination offset. Use with limit to page through results.

Example

curl "https://api.polynode.dev/v2/markets/crypto?limit=50&offset=0&key=YOUR_API_KEY"

{
  "category": "crypto",
  "counts": {
    "all": 260,
    "fiveM": 7,
    "fifteenM": 7,
    "pre-market": 112,
    "etf": 2,
    "hourly": 9,
    "fourhour": 7,
    "daily": 11,
    "weekly": 64,
    "monthly": 23,
    "yearly": 22,
    "bitcoin": 35,
    "ethereum": 21,
    "solana": 12,
    "xrp": 11,
    "dogecoin": 6,
    "bnb": 6,
    "microstrategy": 8
  },
  "events": [
    {
      "id": "273112",
      "slug": "bitcoin-above-on-april-23",
      "title": "Bitcoin above ___ on April 23?",
      "image": "https://...",
      "volume": 12345678,
      "volume24hr": 5678901,
      "liquidity": 1234567,
      "openInterest": 890123,
      "startDate": "2025-04-22T00:00:00Z",
      "endDate": "2025-04-23T23:59:59Z",
      "active": true,
      "closed": false,
      "new": false,
      "featured": true,
      "competitive": true,
      "commentCount": 42,
      "tags": ["Crypto", "Bitcoin"]
    }
  ],
  "limit": 50,
  "offset": 0
}

Response Fields

Each event object includes:

Field	Type	Description
id	string	Event ID
slug	string	URL slug
title	string	Event title
image	string	Event image URL
volume	number	Total lifetime volume
volume24hr	number	24-hour trading volume
liquidity	number	Current liquidity
openInterest	number	Open interest
startDate	string	Event start date (ISO 8601)
endDate	string	Event end date (ISO 8601)
active	boolean	Whether the event is active
closed	boolean	Whether the event is closed
new	boolean	Whether the event is new
featured	boolean	Whether the event is featured
competitive	boolean	Whether the event is competitive
commentCount	number	Number of comments
tags	string[]	Category tags

Pagination

Page through all markets in a category:

import requests

API_KEY = "pn_live_..."
category = "politics"
all_events = []
offset = 0

while True:
    resp = requests.get(
        f"https://api.polynode.dev/v2/markets/{category}",
        params={"key": API_KEY, "limit": 100, "offset": offset},
    ).json()
    events = resp.get("events", [])
    if not events:
        break
    all_events.extend(events)
    offset += len(events)

print(f"Total {category} events: {len(all_events)}")

The counts object varies by category. Crypto includes subcounts by asset and timeframe. Other categories return a simple {"total": N} count. Counts are cached and may not exactly match the paginated event total.

Authorizations

x-api-key · string · header · required

Path Parameters

category · string · required

Category slug: crypto, politics, sports, finance, economy, tech, pop-culture, geopolitics, weather, iran, elections, mentions

Response

200

application/json

Category markets

The response is of type object.