gbR discord commands

gbR — short for gexbot Research — is the Discord bot that renders gexbot Research charts in your server. It runs on slash commands. Type / in any channel the bot can post in, and Discord shows the command list.

How a command reads

Every chart command takes a required symbol, then optional filters:

/gex symbol:SPX
/iv mid symbol:SPY end_dte:30
/oi symbol:QQQ strikes:40

Commands come in two shapes:

• A family parent plus a subcommand — /gamma exposure, /iv mid, /delta ask. The parent groups a greek and names the axis.
• A command on its own — /gex, /oi, /flip. These name a thing rather than a point on an axis, so they are top-level commands. Discord's picker matches on the top-level name, which is why /oi has to be /oi.

The symbol option is autocompleted. An option you leave out takes its default.

1. Exposure shortcuts

Four commands chart the exposure most people want, with the opinionated view the legacy !gex always drew.

All four preset the same three options:

Invoked with no weighting, a shortcut charts all three weightings at once and returns them as one three-up card. Add weighting: to get a single chart:

/gex symbol:SPX                    → open interest, volume and both, in one card
/gex symbol:SPX weighting:volume   → one chart, weighted by volume
/gamma exposure symbol:SPX end_dte:98   → the unopinionated twin

2. Greek families

Thirteen parent commands group a greek family. Each charts the greek at ask, bid or mid, and carries its exposure subcommand.

Notes:

• exposure is one subcommand per greek, never one per weighting. Select the weighting with the weighting option.
• Gamma, delta, theta and vega name their exposure with a short prefix. Gamma exposure is GEX, not GAMMA_EX. That is why the four shortcuts above exist.
• /iv is the only family that offers view. See the next section.

3. Implied volatility

/smile presets start_dte:0, end_dte:365, expiration_filter:m and moneyness_filter:d10, so it shows the term structure of the skew rather than the near-dated smile. Every preset stays yours to override.

Chart layouts (view)

Only the /iv subcommands offer view, because the volatility family is the only one built for every layout.

/iv mid symbol:SPX view:mirror
/iv mid symbol:SPX view:surface end_dte:180

4. Levels and market data

• /flip is also /gamma flip. /gamma wall and /gamma wall_abs draw the same chart — a gamma wall is a level of the flip chart, not a chart of its own. The card carries a table with one row per expiration, and attaches every row as a document.
• /max states its caveats on the card. Read them: max pain is easy to act on and easy to misread. The slash command presets nothing, so it uses the default 0–98 window. The legacy !max presets end_dte=64.
• /volume is refused before the open, because the day's volume is still zero. The same applies to weighting:volume and weighting:both on any exposure command.

Three metrics are deliberately absent from Discord. VOL_TRIGGER is absent because /flip already charts GAMMA_FLIP. INTRINSIC and EXTRINSIC are withheld for compliance. All three stay reachable through the research API.

5. Options and filters

Every chart command takes symbol, then any of these.

A few things worth knowing:

• weighting selects the metric, it does not filter the chart. GEX_OI, GEX_VOL and GEX_BOTH are three different metrics. That is why it is offered only where a weighted family sits behind the command.
• Discord offers three formats. The research API also emits svg, pdf, html, plotly, csv and json, but none of those render in a Discord message.
• A window with no expirations does not fail. The bot moves to the first expiration at or after start_dte, and says so on the card.
• The strike count decides how tall the card is. A large strikes gives a tall image.

6. Account and setup

/config needs a gexbot account linked to your Discord account. Sign up free at gexbot.com, then link Discord from the portal.

/config and /help are the two commands that work in a DM. Every other command needs a server and a channel the server owner has authorized for the bot.

7. Limits

Link your Discord account to a gexbot account for a larger personal allowance. The research addon raises it again, and lifts the server cap. /help is exempt from all of them — the bot will always explain itself, even to somebody it has just rate limited.

8. Symbols

Type the ticker of the underlying. The bot accepts several option-market and futures spellings and resolves each to the chain that exists.

An expiration suffix maps the symbol only. SPXW does not set expiration_filter for you.

9. Legacy ! commands

!help, !commands and !h answer with one line that points at /help. No help content is served from this surface.

The grammar

!command SYMBOL [positional ...] [key=value ...]

• A key=value token is accepted anywhere in the line. The key must be one of format, view, chart_type, theme, type, strikes, start_dte, end_dte, expiration_filter, contract_filter, moneyness_filter, series, model, contract_agg, expiry_agg, skew_adj or limit_y.
• A boolean token anywhere in the tail — yes, no, true, false, on, off, 1, 0 — sets contract_agg.
• Every other bare token fills the command's own positional slots, in order.
• A bare token the command cannot place is an error. It is not read as a view name or a filter name. Select a layout with view=surface, a filter with moneyness_filter=otm, and a draw style with type=histogram.
• strikes clamps to 5–250. Days-to-expiration clamps to 0–1000.
• weighting does not exist on this surface. Name the metric directly on the API route, or use a slash command.

The commands

Positional slots are listed in the order the parser fills them.

Examples:

!gexn SPX end_dte=98        the netted chart over 98 days
!iv SPX view=term           the term structure from the legacy surface
!oi SPX 40 30 m             40 strikes, 30 DTE, monthlies

!gexn SPX 98 is not the same request. A bare 98 fills the first positional slot, which for !gexn is the strike count. Use end_dte=98 when you mean the window.

Retired and deprecated tokens

See also

• research (gbR) — the web terminal, the AI assistant and the REST API.
• research API — the same metrics over HTTP.
• rate limits — how the allowances are counted.