GET
/
v1
/
predictions
/
polymarket
/
events
List Events
curl --request GET \
  --url https://api.example.com/v1/predictions/polymarket/events

​
Upstream Mapping

Maps to Polymarket’s GET /events endpoint on the CLOB API.

​
Request

​
status
string
Filter by status: active, closed, resolved
​
category
string
Filter by category (e.g., Crypto, Politics, Sports)
​
limit
number
Number of events to return. Default 25, max 100.
​
offset
number
Pagination offset

​
Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/predictions/polymarket/events?status=active&category=Crypto&limit=5"
Example Response
[
  {
    "eventId": "12345",
    "title": "Will BTC exceed $100k by end of 2026?",
    "category": "Crypto",
    "status": "active",
    "endDate": "2026-12-31T23:59:59Z",
    "volume": "2500000.00",
    "liquidity": "500000.00",
    "markets": [
      {
        "marketId": "0xabc123",
        "question": "BTC > $100k by Dec 31, 2026",
        "outcomes": ["Yes", "No"],
        "tokens": [
          { "tokenId": "71234", "outcome": "Yes", "price": "0.72" },
          { "tokenId": "71235", "outcome": "No", "price": "0.28" }
        ]
      }
    ]
  }
]

​
Get Single Event

GET /v1/predictions/polymarket/events/:eventId
Returns a single event with full market details.