/api/v1/markets/{id}/tradesGETGet recent trades for a market
Authorization
bearerAuth *Bearer <token>
Clerk session JWT, or an API key (the
ak_ prefix), sent as a Bearer token or an ?api_key= query parameter. Each endpoint requires the read scope for its resource (e.g. org:rates:read for rates). Token in: headerQuery Parameters
page?integer
Page number
Default:
1Min: 1per_page?integer
Items per page
Default:
100Min: 1Max: 500from?string (date-time)
Inclusive lower bound on
timestampto?string (date-time)
Exclusive upper bound on
timestampResponse
200 · Paginated trades
data?object[]
Show item properties
trade_id?string
Identifier for the trade. Kalshi supplies its own trade id; Polymarket fills have no venue id, so theirs is a composite key derived from the settling transaction and the fill's own fields.
timestamp?string (date-time)
When the trade executed on the venue, in UTC.
price?number
Yes-side traded price in cents (0-100), the canonical API scale.
count?integer
Quantity traded: contracts on Kalshi, shares on Polymarket (rounded to a whole number).
side?string
Which side the taker (the aggressing order) was on,
yes or no. Polymarket buy/sell fills are normalized onto the same two values.volume?numbernull
Trade size. Platform-native: Kalshi is USD notional, Polymarket is shares.
meta?object
Show properties
total?integer
Total number of records matching the request across every page, not just the number returned in this one.
page?integer
The 1-based page number this response covers.
per_page?integer
Maximum number of items on a page. The last page may hold fewer.
total_pages?integer
Number of pages available at this
per_page. It is at least 1, even when nothing matched.has_next?boolean
True when a page exists after this one.
has_prev?boolean
True when this is not the first page.
403 · The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.
error *string
Human-readable reason the request was refused.
status *integer
HTTP status code, repeated in the body.
upgrade_url?string (uri)
Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase.
404 · Market not found
error?string
Stable, machine-readable code identifying the failure; branch on this rather than on
message. One of bad_request, unauthorized, forbidden, not_found, conflict, service_unavailable, upstream_error, service_error, or internal_error.message?string
Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld.
429 · The paid organization's minute or UTC-day request budget is exhausted.
error *"rate_limited"
Always
rate_limited. Branch on this to detect a throttled request.limit *"rpm" | "daily"
Which limit was hit:
rpm for the per-minute cap or daily for the daily one.message *string
Human-readable explanation naming the limit that was exceeded.
upgrade_url?string (uri)
Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase.
Request example
curl -X GET "https://api.dev.adjacent.markets/api/v1/markets/<id>/trades" \ -H "Authorization: Bearer <token>"
Response example
{ "data": [ { "trade_id": "d25ba779-817d-6df2-9bc1-e381aeadecbc", "timestamp": "2026-06-03T14:46:34.680308Z", "price": 65, "count": 30, "side": "yes", "volume": 19.5 }, { "trade_id": "acd34816-75a9-6fb6-72f9-f6b48c48a660", "timestamp": "2026-06-03T14:46:31.814730Z", "price": 65, "count": 225, "side": "yes", "volume": 146.25 } ], "meta": { "total": 128113, "page": 1, "per_page": 20, "total_pages": 6406, "has_next": true, "has_prev": false } }