undefined

undefined

if ! command -v gmx-v2 >/dev/null 2>&1; then
  OS=$(uname -s | tr A-Z a-z)
  ARCH=$(uname -m)
  EXT=""
  case "${OS}_${ARCH}" in
    darwin_arm64)  TARGET="aarch64-apple-darwin" ;;
    darwin_x86_64) TARGET="x86_64-apple-darwin" ;;
    linux_x86_64)  TARGET="x86_64-unknown-linux-gnu" ;;
    linux_i686)    TARGET="i686-unknown-linux-gnu" ;;
    linux_aarch64) TARGET="aarch64-unknown-linux-gnu" ;;
    linux_armv7l)  TARGET="armv7-unknown-linux-gnueabihf" ;;
    mingw*_x86_64|msys*_x86_64|cygwin*_x86_64)   TARGET="x86_64-pc-windows-msvc"; EXT=".exe" ;;
    mingw*_i686|msys*_i686|cygwin*_i686)           TARGET="i686-pc-windows-msvc"; EXT=".exe" ;;
    mingw*_aarch64|msys*_aarch64|cygwin*_aarch64)  TARGET="aarch64-pc-windows-msvc"; EXT=".exe" ;;
  esac
  mkdir -p ~/.local/bin
  curl -fsSL "https://github.com/okx/plugin-store/releases/download/plugins/gmx-v2@0.2.1/gmx-v2-${TARGET}${EXT}" -o ~/.local/bin/gmx-v2${EXT}
  chmod +x ~/.local/bin/gmx-v2${EXT}
fi

REPORT_FLAG="$HOME/.plugin-store/reported/gmx-v2"
if [ ! -f "$REPORT_FLAG" ]; then
  mkdir -p "$HOME/.plugin-store/reported"
  # Device fingerprint → SHA256 → 32-char device ID
  DEV_RAW="$(hostname):$(uname -s):$(uname -m):$HOME"
  DEV_ID=$(echo -n "$DEV_RAW" | shasum -a 256 | head -c 32)
  # HMAC signature (obfuscated key, same as CLI binary)
  _K=$(echo 'OE9nNWFRUFdfSVJkektrMExOV2RNeTIzV2JibXo3ZWNTbExJUDFIWnVoZw==' | base64 -d 2>/dev/null || echo 'OE9nNWFRUFdfSVJkektrMExOV2RNeTIzV2JibXo3ZWNTbExJUDFIWnVoZw==' | openssl base64 -d)
  HMAC_SIG=$(echo -n "${_K}${DEV_ID}" | shasum -a 256 | head -c 8)
  DIV_ID="${DEV_ID}${HMAC_SIG}"
  unset _K
  # Report to Vercel stats
  curl -s -X POST "https://plugin-store-dun.vercel.app/install" \
    -H "Content-Type: application/json" \
    -d '{"name":"gmx-v2","version":"0.2.1"}' >/dev/null 2>&1 || true
  # Report to OKX API (with HMAC-signed device token)
  curl -s -X POST "https://www.okx.com/priapi/v1/wallet/plugins/download/report" \
    -H "Content-Type: application/json" \
    -d '{"pluginName":"gmx-v2","divId":"'"$DIV_ID"'"}' >/dev/null 2>&1 || true
  touch "$REPORT_FLAG"
fi

Please connect your wallet first: run `onchainos wallet login`

gmx-v2 --chain arbitrum list-markets
gmx-v2 --chain avalanche list-markets --trading-only false

gmx-v2 --chain arbitrum get-prices
gmx-v2 --chain arbitrum get-prices --symbol ETH
gmx-v2 --chain avalanche get-prices --symbol BTC

gmx-v2 --chain arbitrum get-positions
gmx-v2 --chain arbitrum get-positions --address 0xYourWallet

gmx-v2 --chain arbitrum get-orders
gmx-v2 --chain arbitrum get-orders --address 0xYourWallet

undefined

**Parameters:**
- `--market`: Market name (e.g. "ETH/USD") or index token address
- `--collateral-token`: ERC-20 token used as collateral (address)
- `--collateral-amount`: Collateral in smallest units (USDC = 6 decimals, ETH = 18)
- `--size-usd`: Total position size in USD (collateral × leverage)
- `--long`: presence flag — include for long, omit for short
- `--slippage-bps`: Acceptable slippage in basis points (default: 100 = 1%)
- `--from`: Wallet address (optional, auto-detected)

**Flow:**
1. Run `--dry-run` to preview calldata and estimated leverage
2. Pre-flight: checks ERC-20 collateral token balance — returns `{"ok":false,"error":"INSUFFICIENT_TOKEN_BALANCE"}` JSON if wallet balance < `--collateral-amount`
3. Pre-flight: checks GMX `minCollateralUsd` on-chain — returns `{"ok":false,"error":"INSUFFICIENT_COLLATERAL"}` JSON if post-fee collateral would fall below GMX minimum (keeper would cancel immediately)
4. Pre-flight: checks wallet ETH balance — returns `{"ok":false,"error":"INSUFFICIENT_ETH_FOR_EXECUTION"}` JSON if ETH < execution fee + gas buffer
5. **Ask user to confirm** market, direction, size, slippage, and execution fee
6. If collateral allowance is insufficient, the binary prints a NOTE — re-run with `--confirm` flag to approve and open in one step
7. Submits multicall via `onchainos wallet contract-call`
8. Keeper executes position within 1–30 seconds

**Pre-flight error JSON examples:**
```json
{"ok":false,"error":"INSUFFICIENT_TOKEN_BALANCE","reason":"Wallet collateral token balance is less than the requested collateral amount.","collateral_token":"0xaf88...","wallet_balance":"500000","wallet_balance_usd":"0.5000","required_amount":"1000000","required_amount_usd":"1.0000","suggestion":"Reduce --collateral-amount to at most 500000 or top up the collateral token."}

{"ok":false,"error":"INSUFFICIENT_COLLATERAL","reason":"Post-fee collateral is below GMX minimum. Keeper will cancel the order immediately.","collateral_usd":"1.0000","estimated_open_fee_usd":"0.0050","collateral_after_fee_usd":"0.9950","min_collateral_usd":"1.0000","suggestion":"Increase --collateral-amount so that collateral_after_fee_usd >= min_collateral_usd, or reduce --size-usd to lower the fee."}

{"ok":false,"error":"INSUFFICIENT_ETH_FOR_EXECUTION","reason":"Wallet does not have enough ETH to cover execution fee + gas.","eth_balance":"0.00050000","execution_fee_eth":"0.00100000","gas_buffer_eth":"0.00020000","eth_required":"0.00120000","suggestion":"Top up wallet 0xYourWallet with at least 0.000700 ETH on Arbitrum."}

undefined

**Parameters:**
- `--market-token`: Market token address (from `get-positions` output)
- `--collateral-token`: Collateral token of the position
- `--size-usd`: Size to close in USD (use full position size for full close)
- `--collateral-amount`: Collateral to withdraw
- `--long`: presence flag — include for long positions, omit for short
- `--slippage-bps`: Acceptable slippage in basis points (default: 100 = 1%)

**Flow:**
1. Run `--dry-run` to preview
2. **Ask user to confirm** position details before closing
3. Submits via `onchainos wallet contract-call`
4. Position closes within 1–30 seconds via keeper

---

undefined

**Order types:** `limit-increase`, `limit-decrease`, `stop-loss`, `stop-increase`

**Flow:**
1. Run `--dry-run` to preview trigger and acceptable prices
2. **Ask user to confirm** order type, trigger price, and size before placing
3. Submits via `onchainos wallet contract-call`
4. Order monitored by keeper and executed when trigger is reached

---

gmx-v2 --chain arbitrum cancel-order \
  --key 0x1234abcd...  # 32-byte key from get-orders

undefined

**Flow:**
1. Run `--dry-run` to preview GM tokens to receive
2. **Ask user to confirm** deposit amounts, market, and execution fee
3. Plugin auto-approves tokens if allowance insufficient
4. Submits multicall via `onchainos wallet contract-call`
5. GM tokens minted within 1–30 seconds by keeper

---

gmx-v2 --chain arbitrum withdraw-liquidity \
  --market-token 0xGMTokenAddress \
  --gm-amount 1000000000000000000 \
  --min-long-amount 0 \
  --min-short-amount 0

gmx-v2 --chain arbitrum claim-funding-fees \
  --markets 0xMarket1,0xMarket2 \
  --tokens 0xToken1,0xToken2 \
  --receiver 0xYourWallet

undefined

undefined