Skip to main content
GET
List instruments

Query Parameters

id
string

Filter by instrument ID. Repeatable.

ticker
string

Case-insensitive substring of the ticker.

title
string

Case-insensitive substring of the title.

event_ticker
string

Case-insensitive substring of the event ticker.

series_ticker
string

Case-insensitive substring of the series ticker.

group_ticker
string

Case-insensitive substring of the group ticker.

status
string

Filter by lifecycle status. Repeatable. DRAFT returns 400. Deleted instruments are listed with their last status.

category
string

Filter by the linked Series category. Repeatable.

updated_time_after
string

Only instruments whose updated_time is after this value, in Unix epoch milliseconds (exclusive).

updated_time_before
string

Only instruments whose updated_time is before this value, in Unix epoch milliseconds (exclusive).

list_time_after
string

Only instruments whose list_time is after this value, in Unix epoch milliseconds (exclusive).

list_time_before
string

Only instruments whose list_time is before this value, in Unix epoch milliseconds (exclusive).

open_time_after
string

Only instruments whose open_time is after this value, in Unix epoch milliseconds (exclusive).

open_time_before
string

Only instruments whose open_time is before this value, in Unix epoch milliseconds (exclusive).

close_time_after
string

Only instruments whose close_time is after this value, in Unix epoch milliseconds (exclusive).

close_time_before
string

Only instruments whose close_time is before this value, in Unix epoch milliseconds (exclusive).

settlement_time_after
string

Only instruments whose settlement_time is after this value, in Unix epoch milliseconds (exclusive).

settlement_time_before
string

Only instruments whose settlement_time is before this value, in Unix epoch milliseconds (exclusive).

sort
string

Sort field. Only updated_time is accepted. Without sort, results are ordered newest first by ID.

order
string

Sort direction: asc or desc. Default desc. Used only with sort=updated_time.

limit
string

Page size. Default 100, maximum 1000.

cursor
string

Opaque cursor from the previous page's cursor field. Omit on the first request.

Response

Instruments page

data
object[]
cursor
string