Skip to main content
POST
List upcoming event dates for a tradable.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

JSON request with a non-blank TradableId, PricingDate as a caller-time-zone calendar date, and at most one accessible market-data environment selected by name or identifier.

Tradable and pricing-date selection used to request its next event date.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Tradables.ApiGetNextTradeEventDatesRequest, Derivitec.Web.Core
market_data_environment_name
string | null

Name of the market-data environment to use. Supply either this name or provider_id, not both.

Example:

"Example market data"

provider_id
string | null

Opaque identifier of the market-data provider to use. Supply either this identifier or market_data_environment_name, not both.

tradable_id
string | null

Tradable identifier whose next event date is requested.

pricing_date
string<date-time>

Date from which the next trade-event date is evaluated.

Response

Returns upcoming event dates or an unsuccessful payload with errors.

Response envelope for the next trade-event date of the selected tradable.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Tradables.ApiGetNextTradeEventDatesResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.

next_trade_date
string<date-time>

Next event date for the tradable when the request succeeds.

pricing_date
string<date-time>

Pricing date used to evaluate the next event when the request succeeds.