POST
Search projected market listings

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
view_id
string<uuid>

Saved view filters are combined with request filters using AND semantics.

filters
object

Flexible market filter grammar. Documented fields are typed; additional fields are tolerated for forward-compatible frontend experiments and ignored until implemented.

sort
object[]

The current implementation applies the first sort item and falls back to newest listing activity.

page_size
integer
default:50
Required range: 1 <= x <= 200
cursor
string
display_currency
string
Required string length: 3
Example:

"USD"

include
enum<string>[]

Optional expensive additions. Use extraction_context only on screens that render classification evidence; default listing cards omit it.

Available options:
summary,
facets,
extraction_context
summary_mode
enum<string>

On the summary route, omit price aggregates and return only total and per-side counts for latency-sensitive headers.

Available options:
counts_only

Response

Cursor page of market listings.

items
object[]
required
has_more
boolean
required
next_cursor
string | null
summary
object
facets
object
effective_filter
object

Server-normalized effective filter envelope returned for debugging saved-view and request filter composition.