limit-order

name	limit-order
description	Place a limit order that polls quotes and executes at a target price
allowed-tools	["Bash(tm *)"]
license	MIT

Limit Order

Place a limit order by polling quotes in a loop and executing when the price reaches a target threshold.

Prerequisites

1. CLI installed: go install github.com/true-markets/cli/cmd/tm@latest
2. Signed up: tm signup [e-mail] (creates account, wallet, and API key in one step)

Gather Parameters

Ask the user (or extract from their message) for:

1. Side: buy or sell
2. Token: symbol (e.g., SOL, ETH) or contract address
3. Amount: how much to trade (in default units — USDC for buy, token for sell)
4. Target price: the USDC-per-token price threshold
5. Poll interval (optional, default 10 seconds)

If any required parameter is missing, ask with AskUserQuestion.

Alternative: Use Price Streaming

Instead of polling with dry-run quotes, you can monitor the price via the streaming WebSocket feed:

tm price <token> --stream -o json

This outputs newline-delimited JSON with live price updates. Parse each line and compare against the target price. When the target is reached, stop the stream and run a --dry-run quote to confirm the current execution price before trading. Do not execute a trade based solely on the stream price — always verify with a fresh dry-run quote first.

Get Initial Quote

Run a dry-run to show the current market price:

tm <side> <token> <amount> -o json --dry-run

Parse the JSON output. Compute the current effective price:

• Buy (qty_unit=quote by default): price = qty / qty_out (USDC per token)
• Sell (qty_unit=base by default): price = qty_out / qty (USDC per token)

Display to the user:

• Current price: $X.XX per token
• Target price: $Y.YY per token
• Direction: buying when price drops to target / selling when price rises to target

Ask the user to confirm before starting the loop. If they decline, stop.

Poll Loop

Run the following bash loop. Use a timeout of 600000 (10 minutes max).

The loop logic (as a bash script):

SIDE="<side>"
TOKEN="<token>"
AMOUNT="<amount>"
TARGET="<target_price>"
INTERVAL=<poll_interval>

echo "Limit order active: $SIDE $AMOUNT of $TOKEN at target price \$$TARGET per token"
echo "Polling every ${INTERVAL}s. Press Ctrl+C to cancel."
echo ""

while true; do
  QUOTE=$(tm $SIDE $TOKEN $AMOUNT -o json --dry-run 2>/dev/null)
  if [ $? -ne 0 ]; then
    echo "[$(date '+%H:%M:%S')] Quote failed, retrying..."
    sleep $INTERVAL
    continue
  fi

  QTY=$(jq -r '.qty' <<< "$QUOTE")
  QTY_OUT=$(jq -r '.qty_out' <<< "$QUOTE")
  ISSUES=$(jq '.issues | length' <<< "$QUOTE")

  if [ "$SIDE" = "buy" ]; then
    PRICE=$(echo "$QTY $QTY_OUT" | awk '{printf "%.6f", $1 / $2}')
    HIT=$(echo "$PRICE $TARGET" | awk '{print ($1 <= $2) ? "yes" : "no"}')
  else
    PRICE=$(echo "$QTY_OUT $QTY" | awk '{printf "%.6f", $1 / $2}')
    HIT=$(echo "$PRICE $TARGET" | awk '{print ($1 >= $2) ? "yes" : "no"}')
  fi

  echo "[$(date '+%H:%M:%S')] Price: \$$PRICE | Target: \$$TARGET | Hit: $HIT"

  if [ "$HIT" = "yes" ]; then
    if [ "$ISSUES" != "0" ]; then
      echo "Price target reached but quote has issues. Retrying..."
      sleep $INTERVAL
      continue
    fi
    echo ""
    echo "Target price reached! Executing trade..."
    RESULT=$(tm $SIDE $TOKEN $AMOUNT -o json --force 2>&1)
    echo "$RESULT"
    echo ""
    echo "Limit order complete."
    break
  fi

  sleep $INTERVAL
done

Important rules:

• Substitute actual values for <side>, <token>, <amount>, <target_price>, <poll_interval>.
• Run this as a single bash command (join lines with ; or use a heredoc).
• Use timeout of 600000 so it runs for up to 10 minutes.
• Tell the user they can press Ctrl+C or Escape to cancel at any time.
• After execution completes (or the loop exits), report the final result.

After Execution

Parse the trade result JSON and report:

• Whether the trade executed successfully
• The transaction hash and explorer link (if present)
• The final execution price vs the target price