Skip to main content
GET
Get Trades
Cross-venue by default. venue defaults to all, returning merged sim_trades + real_trades sorted by created_at desc. Each row is tagged with a venue field. Pass ?venue=sim|polymarket|kalshi to filter to a single venue.

Query Parameters

venue
string | null
default:all

Venue filter: 'all' (default — sim + polymarket merged), 'sim', 'polymarket', or 'kalshi'

limit
integer
default:50

Max trades to return

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

Offset for pagination

Required range: x >= 0
agent_id
string | null

Filter trades to a specific SDK agent ID (sim trades only)

market_id
string | null

Filter to a specific market ID (UUID); applies to both sim and real trades

since
string | null

ISO-8601 datetime: include trades at or after this time (e.g. 2025-01-01T00:00:00Z)

until
string | null

ISO-8601 datetime: include trades at or before this time

include_failed
boolean
default:false

Include failed/cancelled/expired trades (default false). Failed rows carry failure_category and failure_reason fields.

Response

Successful Response