---
title: "List events for sitemap generation"
method: GET
path: "/api/v1/sitemap/events"
tags: ["sitemap"]
---

# List events for sitemap generation

`GET /api/v1/sitemap/events`

## Request

- Base URL: `https://api.pdata.world`
- URL: `https://api.pdata.world/api/v1/sitemap/events`
- Auth: none declared

Open + above-threshold + top-level events, sorted by recency.

Filter: `NOT closed AND volume_24hr >= $1 AND
parent_event_id IS NULL`. The frontend handler caches at
`revalidate=3600`, so this endpoint runs at most once per hour
per worker — no CDN caching needed here.

## Query parameters

- `min_volume_24h` number: Minimum 24h notional volume to be included.
- `limit` integer

## Response `200`

Successful Response

- SitemapEventOut[]
  - `source` string, required
  - `id` string, required
  - `lastmod` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pdata/apis/pdata-backend.md) · [All operations](https://skmtc.dev/pdata/apis/pdata-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/pdata/apis/pdata-backend/revisions/4c9bf3856786?raw)
