dexterm-cli 0.1.6 → 0.1.7

package/dist/packages/autotrade/assets/exit-profile.schema.json

@@ -0,0 +1,492 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dexterm.xyz/schemas/exit-profile.schema.json",
+  "title": "dexterm exit profile 1.2.0",
+  "description": "One per-coin exit profile: how a PAPER position is sized, scaled out, trailed, timed and abandoned. The seed data model of the dexterm strategy builder. Percentages are whole percents relative to the average entry price unless a field says otherwise. Version 1.2.0 (AUTOTRADE-SPEC section 1) extends 1.0.0 additively: wake and maxHoldMinutes (1.1.0), costRecovery and bagTrail (1.2.0). required is unchanged, so every 1.0.0 and 1.1.0 profile stays valid. Cross-field rules the schema cannot express (TP ladder ascending, sellFrac sum <= 1, an enabled hard stop needs atPct, a bagTrail needs costRecovery, TP steps above costRecovery.atPct) are checked by validateExitProfile in @dexterm/autotrade and by the challenge kit validateProfile.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "id",
+    "name",
+    "version",
+    "description",
+    "fit",
+    "sizing",
+    "tpLadder",
+    "trailingStop",
+    "timeStop",
+    "hardStop",
+    "thesisBreak",
+    "reentry",
+    "carry",
+    "reprofileTo"
+  ],
+  "properties": {
+    "kind": {
+      "const": "exit-profile"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,31}$",
+      "description": "Stable id the agent names in its PROFILE line."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 40
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 400
+    },
+    "fit": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "When the agent should pick this profile, from the vet evidence. Advisory: the agent states its evidence in the PROFILE line.",
+      "required": [
+        "summary",
+        "minLiquidityUsd",
+        "ageHours"
+      ],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "minLiquidityUsd": {
+          "type": "number",
+          "minimum": 10000
+        },
+        "ageHours": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "min",
+            "max"
+          ],
+          "properties": {
+            "min": {
+              "type": "number",
+              "minimum": 0
+            },
+            "max": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "minimum": 0
+            }
+          }
+        },
+        "maxTop10Pct": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 0,
+          "maximum": 100
+        },
+        "signals": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "maxItems": 8
+        }
+      }
+    },
+    "sizing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "maxSizePctOfBankroll"
+      ],
+      "properties": {
+        "maxSizePctOfBankroll": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 25,
+          "description": "Max entry cost as % of the CURRENT book bankroll (before the breaker multiplier). The size is the risk: a rug takes ~100%."
+        }
+      }
+    },
+    "tpLadder": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 6,
+      "description": "Take-profit steps. sellFrac is a fraction of the ORIGINAL position size (0.25 = a quarter of what was bought).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "atPct",
+          "sellFrac"
+        ],
+        "properties": {
+          "atPct": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "maximum": 10000
+          },
+          "sellFrac": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "maximum": 1
+          }
+        }
+      }
+    },
+    "trailingStop": {
+      "description": "Once the price has been at least armAtPct above entry, exit the remainder when it falls trailPct from the highest price since entry. null = no trail.",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "armAtPct",
+            "trailPct"
+          ],
+          "properties": {
+            "armAtPct": {
+              "type": "number",
+              "minimum": 0
+            },
+            "trailPct": {
+              "type": "number",
+              "minimum": 5,
+              "maximum": 60
+            }
+          }
+        }
+      ]
+    },
+    "timeStop": {
+      "description": "If the position has not reached ifBelowPct within `minutes` of entry: exit it, review it (a written judgment, no forced exit), or tighten (re-profile down). null = none.",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "minutes",
+            "ifBelowPct",
+            "action"
+          ],
+          "properties": {
+            "minutes": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 10080
+            },
+            "ifBelowPct": {
+              "type": "number"
+            },
+            "action": {
+              "enum": [
+                "exit",
+                "review",
+                "tighten"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "hardStop": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "atPct",
+        "why"
+      ],
+      "description": "Optional hard invalidation stop. Opt-in per profile, with the reason written down.",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "atPct": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "maximum": 0,
+          "minimum": -90
+        },
+        "why": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 400
+        }
+      }
+    },
+    "thesisBreak": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "liquidityDropPct",
+        "liquidityWindowMin",
+        "mcapDivergenceX",
+        "devSell",
+        "volumeDeath"
+      ],
+      "description": "Evidence on the coin's own reads that the thesis is broken: exit everything, the next call is paper_close fraction 1.",
+      "properties": {
+        "liquidityDropPct": {
+          "type": "number",
+          "minimum": 5,
+          "maximum": 90,
+          "description": "Pool liquidity down this % from its highest read in the window."
+        },
+        "liquidityWindowMin": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 60
+        },
+        "mcapDivergenceX": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 1.5,
+          "description": "Jupiter vs DexScreener market cap more than X apart (get_token pair.mcapResolved), or flagged."
+        },
+        "devSell": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "exitOnAnyDevSell",
+            "topHolderSellPctOfBag"
+          ],
+          "properties": {
+            "exitOnAnyDevSell": {
+              "type": "boolean"
+            },
+            "topHolderSellPctOfBag": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "minimum": 1,
+              "maximum": 100
+            }
+          }
+        },
+        "volumeDeath": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "m5TradesBelow",
+                "forMinutes"
+              ],
+              "properties": {
+                "m5TradesBelow": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "forMinutes": {
+                  "type": "number",
+                  "minimum": 1
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "reentry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "allowed",
+        "cooldownMinutes",
+        "maxEntriesPerCoinPerSession",
+        "requires"
+      ],
+      "properties": {
+        "allowed": {
+          "type": "boolean"
+        },
+        "cooldownMinutes": {
+          "type": "number",
+          "minimum": 0
+        },
+        "maxEntriesPerCoinPerSession": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
+        },
+        "requires": {
+          "type": "string",
+          "maxLength": 300
+        }
+      }
+    },
+    "carry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "allowed",
+        "requiresTpFilled",
+        "maxRemainderPctOfBankroll"
+      ],
+      "description": "May an open position stay open across the gap between sessions (unmanaged)?",
+      "properties": {
+        "allowed": {
+          "type": "boolean"
+        },
+        "requiresTpFilled": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 6,
+          "description": "How many TP steps must have filled first."
+        },
+        "maxRemainderPctOfBankroll": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 25
+        }
+      }
+    },
+    "reprofileTo": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]{1,31}$"
+      },
+      "maxItems": 8,
+      "uniqueItems": true,
+      "description": "Profiles this one may switch to mid-trade (with a logged REPROFILE line). Upgrades need TP1 filled; a fired trigger is executed first."
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "maxLength": 300
+      },
+      "maxItems": 8
+    },
+    "costRecovery": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "atPct",
+            "maxSellFrac"
+          ],
+          "properties": {
+            "atPct": {
+              "type": "number",
+              "minimum": 10,
+              "maximum": 10000
+            },
+            "maxSellFrac": {
+              "type": "number",
+              "minimum": 0.1,
+              "maximum": 0.9
+            }
+          }
+        }
+      ]
+    },
+    "bagTrail": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "trailPct"
+          ],
+          "properties": {
+            "trailPct": {
+              "type": "number",
+              "minimum": 10,
+              "maximum": 90
+            },
+            "armAtPct": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        }
+      ]
+    },
+    "wake": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "onTpFilled",
+        "onTimeReview",
+        "drawdownPct",
+        "thesisWarnFrac",
+        "noAnswer"
+      ],
+      "properties": {
+        "onTpFilled": {
+          "type": "boolean"
+        },
+        "onTimeReview": {
+          "type": "boolean"
+        },
+        "drawdownPct": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": -95,
+          "maximum": -1
+        },
+        "thesisWarnFrac": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 0.1,
+          "maximum": 0.95
+        },
+        "noAnswer": {
+          "enum": [
+            "hold",
+            "exit"
+          ]
+        },
+        "onCostRecovered": {
+          "type": "boolean"
+        }
+      }
+    },
+    "maxHoldMinutes": {
+      "type": [
+        "number",
+        "null"
+      ],
+      "minimum": 1,
+      "maximum": 43200
+    }
+  }
+}

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
+}