Skip to main content
GET
Get Incentive Programs

Authorizations

Authorization
string
header
required

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

Query Parameters

pageSize
integer<int32>

Number of markets to return per page. Use with pageToken for pagination. Example: 10

pageToken
string

Pagination token from a previous response's nextPageToken field. Omit for the first request

symbols
string[]

Filter by market symbols. Returns only programs for the specified markets. Example: aec-nba-bos-nyk-2026-04-01

orderBy
enum<string>

Field to sort results by. created_at sorts by program start time, reward sorts by reward pool size

Available options:
created_at
orderDirection
enum<string>

"asc" | "desc" (default: "desc")

Available options:
asc,
desc
statuses
string[]

filter by status: "active", "closed", "pending"

programType
string

filter by program type (optional, e.g. "liquidityProgram", "volumeProgram")

query
string

case-insensitive substring match on market_slug

instrumentStates
enum<string>[]

filter by instrument lifecycle state (empty = no filter)

Available options:
INSTRUMENT_STATE_OPEN,
INSTRUMENT_STATE_PREOPEN,
INSTRUMENT_STATE_SUSPENDED,
INSTRUMENT_STATE_EXPIRED,
INSTRUMENT_STATE_TERMINATED,
INSTRUMENT_STATE_HALTED,
INSTRUMENT_STATE_MATCH_AND_CLOSE_AUCTION,
INSTRUMENT_STATE_PENDING
category
string

filter by instrument metadata "event_category" (exact match)

subcategory
string

filter by instrument metadata "event_subcategory" (exact match)

Response

200 - application/json

A successful response.

programs
object[]

Incentive programs grouped by market

nextPageToken
string

Pagination token for next page. Empty if no more results