ForecastEx Contract Example

Given the information above, we can establish a working example against the Global Carbon Dioxide Emissions contract on the ForecastTrader Website.

Reviewing the page to the right, we can see all of the contract details necessary to get started.

1. Above the chart next to the contract name, we can see the Symbol, “GCE”.
2. On the left side of the web page, we can find the contract’s expiration date, June 30, 2026.
3. Equally important is the value on the right, “Market closes in 287 days.”
4. The bolded excess on the top, 40,5000, indicates our strike price. This can be corroborated by the table on the left which acts like an Option Chain table users may be more familiar with.

While not explicitly stated in the web page, there are several details that may be inferred based on the information present:

1. All ForecastEx contracts use the “OPT” security type, as mentioned in the [Contract Definition & Discovery](/tws-api/doc/event-trading/contract-definition-discovery/introduction) section above.
2. The ForecastEx exchange value is always listed as “FORECASTX”.
3. All currently offered Event Contracts are hosted in the United States of America, and therefore will always use “USD” as their currency value.
4. “Yes” or “No” contracts are based on option rights, “Call” and “Put” respectively.

In order to request our specific contract, we will need to focus on the “Market closes in 287 days” statement. This value indicates the last day the contract may be traded.

This document is written on the 19th of March, 2025. That is the 78th day of the calendar year.

Given the context that this is day 78, and the market will close in 287 days, the contract’s last trade date would then be the 365th day of the year, or December 31st, 2025.

Given the TWS API date standards, this will be written as 20251231.

This information can now be distilled into a standard TWS API contract definition:

Symbol: “GCE”

SecType: “OPT”

Exchange: “FORECASTX”

Currency: “USD”

LastTradeDateOrContractMonth: “20251231”

Right: “C”

Strike: 40500

1
contract= Contract()
2
contract.symbol = "GCE"
3
contract.secType = "OPT"
4
contract.currency = "USD"
5
contract.exchange = "FORECASTX"
6
contract.lastTradeDateOrContractMonth = "20251231"
7
contract.right = "C"
8
contract.strike = 40500