---
title: "List canonical cross-venue event identities"
method: GET
path: "/api/prediction-markets/canonical"
tags: ["public-pm-data"]
---

# List canonical cross-venue event identities

`GET /api/prediction-markets/canonical`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/prediction-markets/canonical`
- Auth: none required

Keyless cursor-paged directory of active canonical events — CoinRithm's
stable cross-venue identity for one real-world question, independent of
any single venue's slug.

The identifier is specified as an adoptable standard, including its
permanence guarantees and the rule that a merged key never 404s:
https://github.com/CoinRithm/coinrithm-agent-trading/blob/main/EVENT_ID_STANDARD.md

Lists ACTIVE canonicals only; merged ones remain resolvable by key via
the detail endpoint. A canonical exists only where at least two venues
listed the same question, so this is a cross-venue cluster directory
rather than a catalogue of every event.

## Query parameters

- `limit` integer
- `cursor` integer

## Response `200`

Paginated canonical directory

- PublicPmCanonicalListResponse
  - `data` object[], required
    - `uuid` string
    - `slug` string
    - `title` string
    - `revision` integer
    - `status` string
    - `memberCount` integer
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `pagination` object, required
    - `limit` integer
    - `nextCursor` integer, nullable

## Other responses

- `500`: Server error

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)