Skip to main content
GET
/
api
/
events
List events
curl --request GET \
  --url http://localhost:8000/api/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "pear_3f8a1b2c",
      "slug": "super-bowl-lix-2025",
      "title": "Super Bowl LIX 2025",
      "description": "Prediction markets for Super Bowl LIX outcomes including winner, MVP, and prop bets.",
      "category": "Sports",
      "source_type": "matched",
      "venue_event_ids": {
        "kalshi": "SUPERBOWL-2025",
        "polymarket": "0x1234abcd"
      }
    },
    {
      "id": "pear_9d4e5f6a",
      "slug": "fed-rate-decision-march-2025",
      "title": "Federal Reserve Rate Decision - March 2025",
      "description": "Will the Federal Reserve cut, hold, or raise interest rates at the March 2025 FOMC meeting?",
      "category": "Economics",
      "source_type": "matched",
      "venue_event_ids": {
        "kalshi": "FED-RATE-MAR25",
        "polymarket": "0x5678efgh"
      }
    }
  ],
  "next_cursor": "eyJpZCI6InBlYXJfOWQ0ZTVmNmEifQ==",
  "has_more": true,
  "total_count": 11507
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer mk_live_...

Query Parameters

​
category
string

Filter events by category. Use the /api/events/categories endpoint to see all available categories.

Example:

"Sports"

​
source_type
enum<string>

Filter by how the event was sourced across platforms.

Available options:
matched,
polymarket_only,
kalshi_only
​
cursor
string

Cursor for pagination. Pass the next_cursor value from a previous response to get the next page.

​
limit
integer
default:50

Maximum number of events to return per page.

Required range: 1 <= x <= 200

Response

A paginated list of Pear events.

Paginated response containing Pear events.

​
data
object[]
​
next_cursor
string | null

Cursor to pass for the next page of results. Null if no more pages.

​
has_more
boolean

Whether there are more results available.

​
total_count
integer

Total number of results matching the query.