Forecastex

Join the Graylayer Discord

Request an API key in #api-key-request under the Community tab.

Platform key: forecastex · Path-based routing to forecastex.com and IBKR Client Portal Gateway. Forecastex provides Interactive Brokers event contract data. The integration is read-only—no trading endpoints.

forecastex.com paths

Upstream: https://forecastex.com/api

Method	Path	Description
GET	`/contracts`	List event contracts

Query parameters for `/contracts`

Parameter	Type	Description
`page`	integer	Page number (1-indexed)
`pageSize`	integer	Results per page
`sortBy`	string	Field to sort by (e.g. `open_interest`, `volume`)
`sortOrder`	string	`asc` or `desc`

curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/forecastex/contracts?page=1&pageSize=100&sortBy=open_interest&sortOrder=desc"

curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/forecastex/contracts?page=1&pageSize=50&sortBy=volume&sortOrder=desc"

IBKR Gateway paths

Upstream: https://localhost:5000/v1/api or https://api.ibkr.com/v1/api Requires IBKR Client Portal Gateway running locally. Set FORECASTEX_IBKR_BASE_URL in .env. Tickle runs every 60s to keep the session alive.

Method	Path	Description
GET	`/trsrv/event/category-tree`	Event contract category tree
GET	`/tickle`	Keep session alive
GET	`/iserver/secdef/search`	Search underlying index (query: `symbol`)
GET	`/iserver/secdef/strikes`	Strike values
GET	`/iserver/secdef/info`	Contract info
GET	`/forecast/category/tree`	Category tree
GET	`/forecast/contract/details`	Contract details (query: `conid`)
GET	`/forecast/contract/market`	Contracts for market (query: `underlyingConid`)
GET	`/forecast/contract/rules`	Contract rules (query: `conid`)
GET	`/forecast/contract/schedules`	Trading schedules (query: `conid`)

curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/forecastex/trsrv/event/category-tree"

curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/forecastex/tickle"

curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/forecastex/forecast/contract/details?conid=12345"

Getting started

Platforms

WebSockets

Join the Graylayer Discord

forecastex.com paths

Query parameters for `/contracts`

IBKR Gateway paths

Join the Graylayer Discord

​forecastex.com paths

​Query parameters for /contracts

​IBKR Gateway paths

forecastex.com paths

Query parameters for `/contracts`

IBKR Gateway paths