---
title: "Discover cross-venue matched market prices"
method: GET
path: "/v0/matched-prices"
tags: ["MatchedPrices"]
---

# Discover cross-venue matched market prices

`GET /v0/matched-prices`

Bulk cross-venue price comparison. Returns matched market pairs from the market_matches table, computing price differences across venues.

## Query parameters

- `relations` string
- `minDifference` number
- `category` string
- `limit` integer
- `minConfidence` number
- `includePrices` boolean

## Response `200`

Matched market pairs sorted by price difference descending.

- object
  - `data` object[]
    - `marketA` UnifiedMarket
      - `marketId` string, required
      - `eventId` string, nullable
      - `title` string, required
      - `slug` string, required
      - `description` string, nullable
      - `url` string, nullable
      - `image` string, nullable
      - `category` string, nullable
      - `tags` string[], nullable
      - `volume` number, nullable
      - `volume24h` number
      - `liquidity` number
      - `openInterest` number, nullable
      - `resolutionDate` string, date-time, nullable
      - `tickSize` number, nullable
      - `status` string, nullable
      - `contractAddress` string, nullable
      - `outcomes` UnifiedOutcome[], required
        - `outcomeId` string, required
        - `marketId` string, required
        - `label` string, required
        - `price` number, nullable
        - `priceChange24h` number, nullable
        - `bestBid` number, nullable
        - `bestAsk` number, nullable
        - `metadata` object, nullable
    - `marketB` UnifiedMarket
      - `marketId` string, required
      - `eventId` string, nullable
      - `title` string, required
      - `slug` string, required
      - `description` string, nullable
      - `url` string, nullable
      - `image` string, nullable
      - `category` string, nullable
      - `tags` string[], nullable
      - `volume` number, nullable
      - `volume24h` number
      - `liquidity` number
      - `openInterest` number, nullable
      - `resolutionDate` string, date-time, nullable
      - `tickSize` number, nullable
      - `status` string, nullable
      - `contractAddress` string, nullable
      - `outcomes` UnifiedOutcome[], required
        - `outcomeId` string, required
        - `marketId` string, required
        - `label` string, required
        - `price` number, nullable
        - `priceChange24h` number, nullable
        - `bestBid` number, nullable
        - `bestAsk` number, nullable
        - `metadata` object, nullable
    - `priceDifference` number
    - `venueA` string
    - `venueB` string
    - `priceA` number
    - `priceB` number
    - `relation` 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint'
    - `confidence` number
    - `reasoning` string, nullable
  - `meta` object
    - `count` integer
    - `limit` integer

## Other responses

- `400` — Invalid query parameters.

## Changes

- **2026-05-22** `16a5aabeaf32` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2/changes/v0/matched-prices/get.md)

---

[API](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2.md) · [All operations](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2/revisions/16a5aabeaf32?raw)