Join the Graylayer Discord
Request an API key in #api-key-request under the Community tab.
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 |
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) |