dexterm-cli 0.1.5 → 0.1.7

package/dist/packages/autotrade/assets/profiles/moonbag.json

@@ -0,0 +1,46 @@
+{
+  "kind": "exit-profile",
+  "id": "moonbag",
+  "name": "Moonbag (early entry, free bag)",
+  "version": "1.2.0",
+  "description": "An early entry on a young pair. At about 2x, sell the slice whose proceeds pay back the whole position cost; the rest rides as a free bag with a loose 55% trail off its peak and the thesis-break exits only. No hard stop, so the size is small: early entries rug often.",
+  "fit": {
+    "summary": "A young pair (0-2 h) with an early clean push that has not gone vertical yet, liquidity >= $20k, and the holder-safety gates clean (no mint or freeze authority, top-10 <= 30%, dev <= 5%).",
+    "minLiquidityUsd": 20000,
+    "ageHours": { "min": 0, "max": 2 },
+    "maxTop10Pct": 30,
+    "signals": ["first clean 5m push with buyers ahead of sellers", "liquidity rising with price", "many distinct buyers, top-2 share low"]
+  },
+  "sizing": { "maxSizePctOfBankroll": 3 },
+  "tpLadder": [],
+  "trailingStop": null,
+  "costRecovery": { "atPct": 100, "maxSellFrac": 0.6 },
+  "bagTrail": { "trailPct": 55 },
+  "timeStop": null,
+  "hardStop": {
+    "enabled": false,
+    "atPct": null,
+    "why": "Young pairs shake out 30-60% before a real run, and a rug fills near -100% whatever stop is set. The protection is the small size, the safety gates at entry and the thesis breaks."
+  },
+  "thesisBreak": {
+    "liquidityDropPct": 40,
+    "liquidityWindowMin": 10,
+    "mcapDivergenceX": 5,
+    "devSell": { "exitOnAnyDevSell": true, "topHolderSellPctOfBag": 30 },
+    "volumeDeath": { "m5TradesBelow": 5, "forMinutes": 60 }
+  },
+  "reentry": {
+    "allowed": false,
+    "cooldownMinutes": 0,
+    "maxEntriesPerCoinPerSession": 1,
+    "requires": "one entry per coin: an early entry cannot be repeated late"
+  },
+  "carry": { "allowed": true, "requiresTpFilled": 0, "maxRemainderPctOfBankroll": 3 },
+  "reprofileTo": [],
+  "wake": { "onTpFilled": false, "onTimeReview": false, "drawdownPct": -50, "thesisWarnFrac": 0.6, "noAnswer": "hold", "onCostRecovered": true },
+  "maxHoldMinutes": 10080,
+  "notes": [
+    "The bag trail arms on the cost-recovery sell, not on a gain; before that only the thesis breaks and the rug floor can exit.",
+    "tighten on a free bag halves its trail (never below 10%); a bag trail is never loosened by an agent."
+  ]
+}

package/dist/packages/autotrade/assets/profiles/runner.json

@@ -0,0 +1,88 @@
+{
+  "kind": "exit-profile",
+  "id": "runner",
+  "name": "Runner (long hold)",
+  "version": "1.1.0",
+  "description": "A conviction hold for a large move: quarters at +100% and +200%, then the last half trails 40% off its peak. No hard stop, a 4-hour review, may carry a small remainder between agent sessions.",
+  "fit": {
+    "summary": "At least ~6 h old, liquidity >= $50k, top-10 <= 25% (or holder data unavailable with a stronger tape), a narrative heating up; or an upgrade from scalp/swing after TP1 filled.",
+    "minLiquidityUsd": 50000,
+    "ageHours": {
+      "min": 6,
+      "max": null
+    },
+    "maxTop10Pct": 25,
+    "signals": [
+      "narrative heating",
+      "liquidity rising with price",
+      "many distinct buyers, top-2 share low"
+    ]
+  },
+  "sizing": {
+    "maxSizePctOfBankroll": 20
+  },
+  "tpLadder": [
+    {
+      "atPct": 100,
+      "sellFrac": 0.25
+    },
+    {
+      "atPct": 200,
+      "sellFrac": 0.25
+    }
+  ],
+  "trailingStop": {
+    "armAtPct": 100,
+    "trailPct": 40
+  },
+  "timeStop": {
+    "minutes": 240,
+    "ifBelowPct": 25,
+    "action": "review"
+  },
+  "hardStop": {
+    "enabled": false,
+    "atPct": null,
+    "why": "A runner has to survive the -20% to -45% shakeouts that come before most large moves. Rugs are handled by the thesis-break rules and by size."
+  },
+  "thesisBreak": {
+    "liquidityDropPct": 30,
+    "liquidityWindowMin": 5,
+    "mcapDivergenceX": 5,
+    "devSell": {
+      "exitOnAnyDevSell": true,
+      "topHolderSellPctOfBag": 25
+    },
+    "volumeDeath": {
+      "m5TradesBelow": 10,
+      "forMinutes": 30
+    }
+  },
+  "reentry": {
+    "allowed": false,
+    "cooldownMinutes": 0,
+    "maxEntriesPerCoinPerSession": 1,
+    "requires": "not in the same session; a later session runs a new full vet"
+  },
+  "carry": {
+    "allowed": true,
+    "requiresTpFilled": 1,
+    "maxRemainderPctOfBankroll": 15
+  },
+  "reprofileTo": [
+    "swing",
+    "scalp"
+  ],
+  "notes": [
+    "A downgrade (tighter exits) is allowed any time with a logged reason.",
+    "1.1.0 adds wake (the judgement calls that wake the position's agent session; noAnswer is what happens when no session answers in time) and maxHoldMinutes (a hard holding cap). Mechanical exits never wait for the session."
+  ],
+  "wake": {
+    "onTpFilled": true,
+    "onTimeReview": true,
+    "drawdownPct": -35,
+    "thesisWarnFrac": 0.6,
+    "noAnswer": "hold"
+  },
+  "maxHoldMinutes": 2880
+}

package/dist/packages/autotrade/assets/profiles/scalp.json

@@ -0,0 +1,88 @@
+{
+  "kind": "exit-profile",
+  "id": "scalp",
+  "name": "Scalp (quick play)",
+  "version": "1.1.0",
+  "description": "A quick momentum play on a young or freshly pushing coin: small size, fast partial profits, a tight trail, a 20-minute clock and a hard stop. Never carried between agent sessions.",
+  "fit": {
+    "summary": "Under ~6 h old, or a fresh 5m push on any coin; tape live with buyers; the move is minutes old. Pick scalp when in doubt.",
+    "minLiquidityUsd": 30000,
+    "ageHours": {
+      "min": 0,
+      "max": 6
+    },
+    "maxTop10Pct": 35,
+    "signals": [
+      "5m change clearly positive",
+      "buys beat sells across >= 25 wallets",
+      "price at or above the 1m VWAP"
+    ]
+  },
+  "sizing": {
+    "maxSizePctOfBankroll": 10
+  },
+  "tpLadder": [
+    {
+      "atPct": 30,
+      "sellFrac": 0.5
+    },
+    {
+      "atPct": 60,
+      "sellFrac": 0.25
+    }
+  ],
+  "trailingStop": {
+    "armAtPct": 20,
+    "trailPct": 15
+  },
+  "timeStop": {
+    "minutes": 20,
+    "ifBelowPct": 10,
+    "action": "exit"
+  },
+  "hardStop": {
+    "enabled": true,
+    "atPct": -25,
+    "why": "A scalp has no thesis beyond the next minutes of momentum: -25% means the read was wrong. It is the smallest size, so the slippage a stop pays costs least here. A rug can still gap through it."
+  },
+  "thesisBreak": {
+    "liquidityDropPct": 20,
+    "liquidityWindowMin": 5,
+    "mcapDivergenceX": 3,
+    "devSell": {
+      "exitOnAnyDevSell": true,
+      "topHolderSellPctOfBag": 25
+    },
+    "volumeDeath": {
+      "m5TradesBelow": 10,
+      "forMinutes": 5
+    }
+  },
+  "reentry": {
+    "allowed": true,
+    "cooldownMinutes": 10,
+    "maxEntriesPerCoinPerSession": 2,
+    "requires": "a new full vet that passes and a new 5m high after the exit"
+  },
+  "carry": {
+    "allowed": false,
+    "requiresTpFilled": 0,
+    "maxRemainderPctOfBankroll": 0
+  },
+  "reprofileTo": [
+    "swing",
+    "runner"
+  ],
+  "notes": [
+    "Upgrade to swing or runner only after TP1 filled, the price is above the TP1 level and every thesis check is clean.",
+    "1.1.0 adds wake (the judgement calls that wake the position's agent session; noAnswer is what happens when no session answers in time) and maxHoldMinutes (a hard holding cap). Mechanical exits never wait for the session."
+  ],
+  "wake": {
+    "onTpFilled": false,
+    "onTimeReview": true,
+    "drawdownPct": null,
+    "thesisWarnFrac": null,
+    "noAnswer": "exit"
+  },
+  "maxHoldMinutes": 60
+}

package/dist/packages/autotrade/assets/profiles/swing.json

@@ -0,0 +1,88 @@
+{
+  "kind": "exit-profile",
+  "id": "swing",
+  "name": "Swing",
+  "version": "1.1.0",
+  "description": "An intraday trend on a coin that has already proven it can hold a pool: medium size, thirds at +50% and +100%, a 25% trail, a 90-minute review, no hard stop (thesis breaks only).",
+  "fit": {
+    "summary": "1 h to 7 d old; above VWAP with higher lows on the 1m candles; liquidity >= $30k and steady; holders not concentrated.",
+    "minLiquidityUsd": 30000,
+    "ageHours": {
+      "min": 1,
+      "max": 168
+    },
+    "maxTop10Pct": 30,
+    "signals": [
+      "trend intact on 1m candles",
+      "liquidity steady or rising vs its 5-min high",
+      "narrative not cooling"
+    ]
+  },
+  "sizing": {
+    "maxSizePctOfBankroll": 15
+  },
+  "tpLadder": [
+    {
+      "atPct": 50,
+      "sellFrac": 0.33
+    },
+    {
+      "atPct": 100,
+      "sellFrac": 0.33
+    }
+  ],
+  "trailingStop": {
+    "armAtPct": 40,
+    "trailPct": 25
+  },
+  "timeStop": {
+    "minutes": 90,
+    "ifBelowPct": 15,
+    "action": "review"
+  },
+  "hardStop": {
+    "enabled": false,
+    "atPct": null,
+    "why": "Recorded winners often dipped 10-25% before they ran, and a rug fills near -100% through any stop. The thesis-break rules and the size are the exit."
+  },
+  "thesisBreak": {
+    "liquidityDropPct": 30,
+    "liquidityWindowMin": 5,
+    "mcapDivergenceX": 5,
+    "devSell": {
+      "exitOnAnyDevSell": true,
+      "topHolderSellPctOfBag": 25
+    },
+    "volumeDeath": {
+      "m5TradesBelow": 10,
+      "forMinutes": 15
+    }
+  },
+  "reentry": {
+    "allowed": true,
+    "cooldownMinutes": 30,
+    "maxEntriesPerCoinPerSession": 1,
+    "requires": "a new full vet that passes"
+  },
+  "carry": {
+    "allowed": true,
+    "requiresTpFilled": 1,
+    "maxRemainderPctOfBankroll": 10
+  },
+  "reprofileTo": [
+    "runner",
+    "scalp"
+  ],
+  "notes": [
+    "Upgrade to runner only after TP1 filled with the price above it and every thesis check clean. Downgrade to scalp any time the trend weakens.",
+    "1.1.0 adds wake (the judgement calls that wake the position's agent session; noAnswer is what happens when no session answers in time) and maxHoldMinutes (a hard holding cap). Mechanical exits never wait for the session."
+  ],
+  "wake": {
+    "onTpFilled": true,
+    "onTimeReview": true,
+    "drawdownPct": -30,
+    "thesisWarnFrac": 0.6,
+    "noAnswer": "exit"
+  },
+  "maxHoldMinutes": 720
+}

package/dist/packages/autotrade/assets/strategies/moonbag.json

@@ -0,0 +1,101 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "moonbag",
+  "name": "Moonbag (early entry, free bag)",
+  "version": "1.0.0",
+  "description": "Small early entries on young pairs that pass the holder-safety gates: take the cost back at about 2x, then hold a free bag with a loose trail and thesis-break exits only. Many small tickets, most of which lose; the point is the rare runner.",
+  "mode": "paper",
+  "bankroll": {
+    "startUsd": 1000
+  },
+  "entry": {
+    "screen": "liq >= 20K vol5m >= 3K !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 0,
+      "max": 2
+    },
+    "safety": {
+      "maxTop10Pct": 30,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 3,
+      "youngVertical": {
+        "maxAgeHours": 2,
+        "maxH1Pct": 150
+      },
+      "unknownHolders": "reject"
+    },
+    "triggers": [
+      {
+        "kind": "momentum",
+        "m5MinPct": 2,
+        "buySellMin": 1.3
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 240
+  },
+  "exits": {
+    "default": "moonbag",
+    "profiles": [
+      "builtin:moonbag"
+    ]
+  },
+  "sizing": {
+    "mode": "pct",
+    "pct": 2,
+    "maxPctOfBankroll": 3,
+    "maxUsd": 50,
+    "minUsd": 2
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 3,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 10,
+    "drawdown": {
+      "sizeDownAtPct": 25,
+      "sizeDownMult": 0.5,
+      "recoverBelowPct": 15,
+      "haltAtPct": 40
+    },
+    "maxConcurrent": 3,
+    "maxExposurePct": 10,
+    "lossStreak": {
+      "losses": 5,
+      "cooldownMin": 120
+    },
+    "maxEntriesPerDay": 8,
+    "perCoin": {
+      "maxEntries": 1,
+      "cooldownMin": 10080
+    },
+    "recoveredBags": {
+      "countAsOpen": false,
+      "maxBags": 6
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 2,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 10,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 60,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 200,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 5,
+    "minExitLiquidityUsd": 2000
+  }
+}

package/dist/packages/autotrade/assets/strategies/runner.json

@@ -0,0 +1,101 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "runner",
+  "name": "Runner (conviction hold)",
+  "version": "1.0.0",
+  "description": "A conviction hold on an established coin with a heating narrative: size scaled by the agent's confidence (5% to 20%), quarters at +100% and +200%, then a 40% trail on the rest.",
+  "mode": "paper",
+  "bankroll": {
+    "startUsd": 1000
+  },
+  "entry": {
+    "screen": "liq >= 50K vol1h > 25K top10 <= 25 !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 6,
+      "max": null
+    },
+    "safety": {
+      "maxTop10Pct": 25,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 5,
+      "youngVertical": null,
+      "unknownHolders": "reject"
+    },
+    "triggers": [
+      {
+        "kind": "screen"
+      },
+      {
+        "kind": "narrative",
+        "minHeat": 60
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 300
+  },
+  "exits": {
+    "default": "runner",
+    "profiles": [
+      "builtin:runner",
+      "builtin:swing"
+    ]
+  },
+  "sizing": {
+    "mode": "confidence",
+    "confidence": {
+      "minPct": 5,
+      "maxPct": 20,
+      "default": 0.5
+    },
+    "maxPctOfBankroll": 20,
+    "maxUsd": 500,
+    "minUsd": 5
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 20,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 15,
+    "drawdown": {
+      "sizeDownAtPct": 25,
+      "sizeDownMult": 0.5,
+      "recoverBelowPct": 15,
+      "haltAtPct": 40
+    },
+    "maxConcurrent": 1,
+    "maxExposurePct": 25,
+    "lossStreak": {
+      "losses": 2,
+      "cooldownMin": 240
+    },
+    "maxEntriesPerDay": 3,
+    "perCoin": {
+      "maxEntries": 1,
+      "cooldownMin": 1440
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 2,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 10,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 90,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 100,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 8,
+    "minExitLiquidityUsd": 2000
+  }
+}

package/dist/packages/autotrade/assets/strategies/sample-dip-ladder.json

@@ -0,0 +1,188 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "sample-dip-ladder",
+  "name": "Dip ladder (custom sample)",
+  "version": "1.0.0",
+  "description": "A user-made sample: buy half on a trend coin, add the other half if it dips 15% within 30 minutes, risk-sized so a full stop-out loses 2% of the bankroll, with an inline exit profile that takes a third at +40% and trails the rest.",
+  "mode": "paper",
+  "bankroll": {
+    "startUsd": 1000
+  },
+  "entry": {
+    "screen": "liq >= 40K vol1h > 20K h1 > 0 !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 2,
+      "max": 72
+    },
+    "safety": {
+      "maxTop10Pct": 30,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 5,
+      "youngVertical": {
+        "maxAgeHours": 3,
+        "maxH1Pct": 200
+      },
+      "unknownHolders": "reject"
+    },
+    "triggers": [
+      {
+        "kind": "screen"
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 300
+  },
+  "exits": {
+    "default": "dip-trail",
+    "profiles": [
+      {
+        "kind": "exit-profile",
+        "id": "dip-trail",
+        "name": "Dip ladder trail",
+        "version": "1.0.0",
+        "description": "A third off at +40%, a third at +90%, the rest trails 20% once it is up 30%. A -35% hard stop below the average entry, because the ladder already bought the dip.",
+        "fit": {
+          "summary": "A trend coin that pulls back inside its first hours with liquidity holding.",
+          "minLiquidityUsd": 40000,
+          "ageHours": {
+            "min": 2,
+            "max": 72
+          },
+          "maxTop10Pct": 30
+        },
+        "sizing": {
+          "maxSizePctOfBankroll": 12
+        },
+        "tpLadder": [
+          {
+            "atPct": 40,
+            "sellFrac": 0.33
+          },
+          {
+            "atPct": 90,
+            "sellFrac": 0.33
+          }
+        ],
+        "trailingStop": {
+          "armAtPct": 30,
+          "trailPct": 20
+        },
+        "timeStop": {
+          "minutes": 180,
+          "ifBelowPct": 10,
+          "action": "review"
+        },
+        "hardStop": {
+          "enabled": true,
+          "atPct": -35,
+          "why": "The ladder already added on the dip; a further -35% from the average means the trend is gone."
+        },
+        "thesisBreak": {
+          "liquidityDropPct": 25,
+          "liquidityWindowMin": 5,
+          "mcapDivergenceX": 5,
+          "devSell": {
+            "exitOnAnyDevSell": true,
+            "topHolderSellPctOfBag": 25
+          },
+          "volumeDeath": {
+            "m5TradesBelow": 8,
+            "forMinutes": 20
+          }
+        },
+        "reentry": {
+          "allowed": false,
+          "cooldownMinutes": 0,
+          "maxEntriesPerCoinPerSession": 1,
+          "requires": "not on the same coin the same day"
+        },
+        "carry": {
+          "allowed": true,
+          "requiresTpFilled": 1,
+          "maxRemainderPctOfBankroll": 8
+        },
+        "reprofileTo": [
+          "swing"
+        ],
+        "wake": {
+          "onTpFilled": true,
+          "onTimeReview": true,
+          "drawdownPct": -20,
+          "thesisWarnFrac": 0.6,
+          "noAnswer": "exit"
+        },
+        "maxHoldMinutes": 1440
+      },
+      "builtin:swing"
+    ]
+  },
+  "sizing": {
+    "mode": "risk",
+    "riskPct": 2,
+    "ladder": [
+      {
+        "frac": 0.5,
+        "atPct": 0,
+        "withinMin": 30
+      },
+      {
+        "frac": 0.5,
+        "atPct": -15,
+        "withinMin": 30
+      }
+    ],
+    "maxPctOfBankroll": 12,
+    "maxUsd": 300,
+    "minUsd": 5
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 10,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 8,
+    "drawdown": {
+      "sizeDownAtPct": 12,
+      "sizeDownMult": 0.5,
+      "recoverBelowPct": 6,
+      "haltAtPct": 20
+    },
+    "maxConcurrent": 3,
+    "maxExposurePct": 30,
+    "lossStreak": {
+      "losses": 2,
+      "cooldownMin": 120
+    },
+    "maxEntriesPerDay": 6,
+    "perCoin": {
+      "maxEntries": 1,
+      "cooldownMin": 1440
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 2,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 10,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 90,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 100,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 8,
+    "minExitLiquidityUsd": 2000
+  },
+  "notes": [
+    "Shareable: copy this file into ~/.dexterm/strategies/ and run `dexterm autotrade validate`."
+  ]
+}