Skip to content

Upcoming markets

GET
/api/markets/schedule
curl --request GET \
--url https://example.com/api/markets/schedule

Windows that have not ended yet, soonest first. To read the next page, pass the last page’s next_after as after.

limit
Any of:
integer

Page size, up to 100. 100 if not given.

count
deprecated
Any of:
integer

The old name for limit. Use limit. Naming both is an error.

after
Any of:
integer
>= -9223372036854776000 <= 9223372036854776000

Only windows after this market in the soonest-first order: the last page’s next_after.

asset
Any of:
string

Only windows on this asset, such as btc.

duration
Any of:
string

Only windows this long, such as 5m.

Successful Response

Media typeapplication/json
SchedulePage
object
markets
required
Markets

Soonest first.

Array<object>
Market
object
market_id
required
Market Id
integer
slug
required
Slug
string
title
required
Title
string
asset
required
Asset
string
category
required
Category
string
duration
required
Duration

Window length, e.g. ‘5m’.

string
series
required
Series

The line of windows this one belongs to, e.g. ‘btc-updown-5m’: the slug without its time.

string
open_ms
required
Open Ms

Window start, epoch ms.

integer
event_ms
required
Event Ms
integer
expiry_ms
required
Expiry Ms

Window end, epoch ms.

integer
status
required
Status

‘open’, then ‘live’ once the window has started and has a strike. ‘halted’ instead of either while trading is halted: orders and changes are refused and cancels taken. ‘closed’ when trading ends: at expiry, or earlier if an operator closes it. ‘settled’ once its outcome is recorded.

string
strike
required
Any of:
number
settlement
required
Any of:
number
winning_outcome
required
Any of:
string
Allowed values: up down void
venue
required
Any of:
string
symbol
required
Any of:
string
candle
required
Any of:
string
taker_fee_rate_bps
required
Taker Fee Rate Bps

The taker’s rate on the fee curve, in basis points. Fixed when the market is listed.

integer
maker_fee_rate_bps
required
Maker Fee Rate Bps

The maker’s rate on the fee curve, in basis points. Fixed when the market is listed.

integer
maker_rebate_share_bps
required
Maker Rebate Share Bps

The part of each fill’s taker fee that the maker gets back, in basis points of that fee. Fixed when the market is listed.

integer
next_after
required
Any of:
integer
Example
{
"markets": [
{
"winning_outcome": "up"
}
]
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}