Skip to main content
GET
Recent contracts

Path Parameters

market
string
required

Market id

Query Parameters

limit
integer

Rows, 1-1000 (default 100)

Response

200 - application/json

OK

created_at
string

When the contract matched. RFC3339 UTC.

Example:

"2026-08-07T10:00:00Z"

id
integer
Example:

1420

market_id
string
Example:

"12"

price
string
Example:

"0.62"

state
enum<string>
Available options:
active,
settled_yes,
settled_no
Example:

"active"

taker_side
enum<string>

TakerSide names the outcome the AGGRESSOR bought — the side that crossed the spread and paid the taker fee. It is what lets a tape be read as pressure rather than as a list of prices: direction inferred from the price moving says nothing on the many fills that print at the price before them.

Empty means UNKNOWN, not "neither". A contract matched before the engine recorded a taker, and any row served from the QuestDB tape (whose contracts table does not carry the taker), report "" — clients must render those as unattributed rather than picking a side.

Available options:
,
yes,
no
Example:

"yes"

volume
string
Example:

"25.5"