Trade Format Guide

MangroveTrader accepts trades via Twitter mentions. The parser uses a regex fast-path for structured commands (90% of trades) and falls back to Grok 4.1 (xAI LLM) for natural language.

Basic Syntax

@MangroveTrader [action] [quantity] [symbol] [@ price]

All fields except action and symbol are optional:

quantity — defaults to 1.0 if omitted
price — resolved via live market data if omitted

Entry Actions

Action	Aliases	Direction
`long`	buy, bought, grabbed, entered, scooped	Long
`short`	sell, sold, faded, dumped, shorted	Short

Exit Actions

Action	Aliases	What It Does
`exit long`	close long, cover long, sold (context)	Closes long position, calculates P&L
`exit short`	close short, cover short, cover	Closes short position, calculates P&L

Examples by Asset Class

Equities

@MangroveTrader long 100 AAPL @ 185.50
@MangroveTrader bought 50 TSLA
@MangroveTrader exit long AAPL @ 192.30
@MangroveTrader short 200 SPY @ 520

Crypto

@MangroveTrader long 0.5 BTC @ 67000
@MangroveTrader bought 10 ETH
@MangroveTrader grabbed some SOL @ 145
@MangroveTrader exit long BTC @ 72000

Symbol aliases: bitcoin → BTC, ethereum → ETH, solana → SOL, corn → BTC

Futures

@MangroveTrader short 5 ES @ 5250
@MangroveTrader long 2 NQ @ 18500
@MangroveTrader exit short ES @ 5200

Options

@MangroveTrader long 10 AAPL 200C 2026-04-18 @ 3.50
@MangroveTrader bought 5 TSLA 300P 2026-06-20

Options require: strike price, C/P (call/put), and expiry date (YYYY-MM-DD).

Natural Language

When the regex parser can't match, Grok 4.1 (non-reasoning, fast) handles natural language:

@MangroveTrader just picked up half a bitcoin
@MangroveTrader dumped my entire TSLA position at 280
@MangroveTrader adding to my ETH bag around 3500

Other Commands

Command	Description
`my stats`	Score, rank, open positions
`leaderboard`	Free top 5 preview
`rank @handle`	Look up another trader's rank
`trades @handle`	Last trade + total count
`watch @handle`	Add to personal watchlist
`unwatch @handle`	Remove from watchlist
`cancel last`	Undo most recent trade (5 min window)
`help`	Show all commands

Rate Limits

10 trades per hour per user (Redis-backed)
Mentions polled every 30 seconds
Commands (stats, rank, etc.) are not rate-limited