Skip to main content
GET
Matched markets with identifiers, outcomes, and current reference prices

Query Parameters

limit
integer
default:50

Maximum number of enriched pairs to return.

Required range: 1 <= x <= 150
offset
integer
default:0

Legacy pagination offset. Do not combine with cursor.

Required range: x >= 0
cursor
string

Opaque keyset cursor. Send an empty value on the first page, then pass each response next_cursor. A 409 requires restarting the walk.

Maximum string length: 16384
provider
string

Filter to pairs where either side belongs to this provider.

min_similarity
number<double>
default:0.82

Minimum similarity, clamped server-side to at least 0.82.

Required range: 0 <= x <= 1
sort_by
enum<string>
default:similarity

Offset-mode sort column. Cursor mode orders by canonical pair identity.

Available options:
similarity,
updated_at
include_total
boolean
default:false

Include the total matching-pair count under pre-live filters.

Response

A page of verified pairs with details and best-effort reference pricing.

pairs
object[]
required
count
integer
required

Number of pairs on this page after live-status post-filtering (may be less than limit).

Example:

42

limit
integer
required
Example:

50

offset
integer
required
Example:

0

has_more
boolean
required

Whether the underlying page (before live-status post-filtering) was full — not a strict function of count.

next_cursor
string | null

Opaque cursor for the next keyset page. Present when cursor mode is requested.

catalog_version
string

Full-set fingerprint shared by every page in one cursor walk.

total
integer

Only present when include_total=true. Total matching-pair count under the pre-live-filter query filters.

Example:

1284