hyperliquid-delta-neutral

OpenTool app

Copy strategy · 0 times Star· 1 Watch· 1

2Branches0Tags

glucryptoMerge remote-tracking branch 'production/master'

cf4a59ba month ago60Commits

hyperliquid-delta-neutral/tools

delta-neutral.ts

Initial commit

—

About

hyperliquid-delta-neutral

OpenTool app

Tool

delta-neutral

Method

POST

Profile

{
  "assets": [
    {
      "chain": "hyperliquid",
      "venue": "hyperliquid",
      "assetSymbols": [
        "BTC"
      ]
    }
  ],
  "backtest": {
    "mode": "decisions"
  },
  "category": "strategy",
  "schedule": {
    "cron": "0 * * * *",
    "enabled": false,
    "notifyEmail": false
  },
  "description": "Delta-neutral strategy (spot + perps) on Hyperliquid.",
  "templateConfig": {
    "envVar": "OPENTOOL_PUBLIC_HL_DELTA_NEUTRAL_CONFIG",
    "schema": {
      "type": "object",
      "required": [
        "platform",
        "allocationMode",
        "spotAsset",
        "perpAsset",
        "targetNotionalUsd",
        "hedgeRatio",
        "slippageBps",
        "expectedCarryHours",
        "deltaDriftPct",
        "environment",
        "schedule"
      ],
      "x-budget": {
        "modes": {
          "target_notional": {
            "fields": [
              "targetNotionalUsd",
              "hedgeRatio"
            ]
          }
        },
        "title": "Budget & allocation",
        "modeField": "allocationMode",
        "defaultMode": "target_notional",
        "description": "Core exposure settings are shown first."
      },
      "properties": {
        "platform": {
          "enum": [
            "hyperliquid"
          ],
          "type": "string",
          "title": "Platform",
          "x-order": 1,
          "readOnly": true,
          "x-section": "Execution",
          "description": "Execution venue for spot + perps."
        },
        "schedule": {
          "type": "object",
          "title": "Schedule",
          "x-section": "Schedule",
          "properties": {
            "cron": {
              "type": "string",
              "title": "Cron expression",
              "x-order": 1,
              "description": "Standard cron expression for the run schedule."
            },
            "enabled": {
              "type": "boolean",
              "title": "Enabled",
              "x-order": 2,
              "description": "Enable the scheduled rebalance."
            },
            "notifyEmail": {
              "type": "boolean",
              "title": "Notify email",
              "x-order": 3,
              "description": "Send an email after each scheduled run."
            }
          },
          "description": "Cron schedule for rebalancing runs."
        },
        "perpAsset": {
          "type": "string",
          "title": "Perp asset",
          "x-order": 2,
          "x-format": "asset",
          "x-section": "Strategy",
          "description": "Perp hedge leg asset for the delta-neutral position (example: BTC)."
        },
        "spotAsset": {
          "type": "string",
          "title": "Spot asset",
          "x-order": 1,
          "x-format": "asset",
          "x-section": "Strategy",
          "description": "Spot leg asset for the delta-neutral position (example: BTC)."
        },
        "hedgeRatio": {
          "type": "number",
          "title": "Hedge ratio",
          "x-step": 0.01,
          "x-unit": "x",
          "minimum": 0.01,
          "x-order": 4,
          "x-section": "Strategy",
          "description": "Multiplier for the hedge leg notional."
        },
        "basisMaxBps": {
          "type": "number",
          "title": "Max basis",
          "x-step": 1,
          "x-unit": "bps",
          "minimum": 0,
          "x-order": 5,
          "x-format": "bps",
          "x-section": "Risk limits",
          "description": "Max basis spread in bps before skipping trades."
        },
        "environment": {
          "enum": [
            "mainnet",
            "testnet"
          ],
          "type": "string",
          "title": "Environment",
          "x-order": 2,
          "x-section": "Execution",
          "description": "Hyperliquid environment for execution.",
          "x-enumLabels": [
            "Mainnet",
            "Testnet"
          ]
        },
        "slippageBps": {
          "type": "number",
          "title": "Slippage",
          "x-step": 1,
          "x-unit": "bps",
          "maximum": 5000,
          "minimum": 0,
          "x-order": 1,
          "x-format": "bps",
          "x-section": "Risk limits",
          "description": "Maximum slippage for marketable orders."
        },
        "perpLeverage": {
          "type": "number",
          "title": "Perp leverage",
          "x-step": 1,
          "x-unit": "x",
          "maximum": 40,
          "minimum": 1,
          "x-order": 3,
          "x-section": "Execution",
          "description": "Target leverage for the perp hedge leg."
        },
        "configVersion": {
          "type": "number",
          "title": "Config version",
          "x-order": 1000,
          "readOnly": true,
          "x-hidden": true,
          "x-section": "Meta",
          "description": "Internal version for delta-neutral config defaults."
        },
        "deltaDriftPct": {
          "type": "number",
          "title": "Delta drift",
          "x-step": 0.1,
          "x-unit": "%",
          "maximum": 50,
          "minimum": 0.1,
          "x-order": 2,
          "x-format": "percent",
          "x-section": "Risk limits",
          "description": "Percent of target notional before rebalancing."
        },
        "fundingMinBps": {
          "type": "number",
          "title": "Min funding",
          "x-step": 0.01,
          "x-unit": "bps",
          "minimum": 0,
          "x-order": 6,
          "x-format": "bps",
          "x-section": "Risk limits",
          "description": "Minimum funding rate in bps to keep the position open."
        },
        "allocationMode": {
          "enum": [
            "target_notional"
          ],
          "type": "string",
          "title": "Allocation mode",
          "x-order": 1001,
          "readOnly": true,
          "x-hidden": true,
          "x-section": "Meta",
          "description": "Canonical sizing mode for delta-neutral templates."
        },
        "perpLeverageMode": {
          "enum": [
            "cross",
            "isolated"
          ],
          "type": "string",
          "title": "Perp leverage mode",
          "x-order": 4,
          "x-section": "Execution",
          "description": "Margin mode for the perp hedge leg.",
          "x-enumLabels": [
            "Cross",
            "Isolated"
          ]
        },
        "targetNotionalUsd": {
          "type": "number",
          "title": "Target notional",
          "x-step": 1,
          "x-unit": "USD",
          "minimum": 1,
          "x-order": 3,
          "x-format": "currency",
          "x-section": "Strategy",
          "description": "Total USD notional for each leg."
        },
        "expectedCarryHours": {
          "type": "number",
          "title": "Carry horizon",
          "x-step": 1,
          "x-unit": "hours",
          "maximum": 8760,
          "minimum": 1,
          "x-order": 5,
          "x-format": "duration",
          "x-section": "Strategy",
          "description": "Hours of funding carry to underwrite before opening the hedge."
        }
      }
    },
    "version": 11,
    "defaults": {
      "platform": "hyperliquid",
      "schedule": {
        "cron": "0 * * * *",
        "enabled": false,
        "notifyEmail": false
      },
      "perpAsset": "BTC",
      "spotAsset": "BTC",
      "hedgeRatio": 1,
      "basisMaxBps": 50,
      "environment": "mainnet",
      "slippageBps": 20,
      "maxPerRunUsd": 1000,
      "perpLeverage": 1,
      "configVersion": 11,
      "deltaDriftPct": 2,
      "fundingMinBps": 0,
      "allocationMode": "target_notional",
      "perpLeverageMode": "cross",
      "targetNotionalUsd": 1000,
      "expectedCarryHours": 720
    }
  },
  "templatePreview": {
    "title": "delta-neutral",
    "subtitle": "Spot and perp balancing to maintain a delta-neutral posture.",
    "description": "Monitors configured markets and computes hedge requirements each cycle.\nBuilds coordinated spot and perp orders to keep directional exposure balanced.\nUses standardized Hyperliquid execution and normalization helpers in OpenTool.\nIncludes risk-aware sizing controls for budget, leverage, and allocation limits.\nOptimized for repeated autonomous operation with transparent execution logs."
  }
}

Tool Path

tools/delta-neutral.js

Input Schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "minimum": 0
    },
    "from": {
      "type": "integer",
      "minimum": 0
    },
    "mode": {
      "type": "string",
      "const": "backtest_decisions"
    },
    "source": {
      "type": "string",
      "minLength": 1
    },
    "symbol": {
      "type": "string",
      "minLength": 1
    },
    "fundingRates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "time",
          "rateBps"
        ],
        "properties": {
          "time": {
            "type": "string",
            "minLength": 1
          },
          "rateBps": {
            "type": "number"
          }
        },
        "additionalProperties": false
      }
    },
    "lookbackDays": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "timeframeEnd": {
      "type": "string"
    },
    "timeframeStart": {
      "type": "string"
    },
    "initialEquityUsd": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}