Oopenpondai/hyperliquid-delta-neutral

Copy strategy · 5 Sign in to star or watch

glucryptoMerge commit 'refs/tmp/prod-master'

src	Initial commit	—
tools	Initial commit	—
metadata.ts	Initial commit	—
package.json	Initial commit	—
README.md	Initial commit	—
tsconfig.json	Initial commit	—

README.md

Hyperliquid Delta-Neutral Template

This template runs a delta-neutral strategy (spot + perps) on Hyperliquid. It exposes a single tool that reads config from OPENTOOL_PUBLIC_HL_DELTA_NEUTRAL_CONFIG and opens/maintains spot + perp hedges based on drift thresholds and a rebalance cadence.

Notes

Config is stored via the templateConfig schema in src/delta-neutral.ts.

Development

opentool dev
opentool build
opentool validate

About

hyperliquid-delta-neutral

OpenTool app

Tool

delta-neutral

Method

GET

Profile

{
  "assets": [
    {
      "chain": "hyperliquid",
      "venue": "hyperliquid",
      "assetSymbols": [
        "BTC"
      ]
    }
  ],
  "category": "strategy",
  "schedule": {
    "cron": "*/30 * * * *",
    "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",
        "asset",
        "targetNotionalUsd",
        "hedgeRatio",
        "slippageBps",
        "rebalanceCadenceMinutes",
        "deltaDriftPct",
        "environment"
      ],
      "x-budget": {
        "modes": {
          "target_notional": {
            "fields": [
              "targetNotionalUsd",
              "hedgeRatio"
            ]
          }
        },
        "title": "Budget & allocation",
        "modeField": "allocationMode",
        "defaultMode": "target_notional",
        "description": "Core exposure settings are shown first."
      },
      "properties": {
        "asset": {
          "type": "string",
          "title": "Asset",
          "x-order": 1,
          "x-section": "Strategy",
          "description": "Base asset to hedge (example: BTC)."
        },
        "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 cadence."
            },
            "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."
        },
        "hedgeRatio": {
          "type": "number",
          "title": "Hedge ratio",
          "x-step": 0.01,
          "x-unit": "x",
          "minimum": 0.01,
          "x-order": 3,
          "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": 1,
          "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": 2,
          "x-format": "currency",
          "x-section": "Strategy",
          "description": "Total USD notional for each leg."
        },
        "rebalanceCadenceMinutes": {
          "type": "number",
          "title": "Rebalance cadence",
          "x-step": 1,
          "x-unit": "minutes",
          "maximum": 720,
          "minimum": 5,
          "x-order": 1,
          "x-format": "duration",
          "x-section": "Rebalance",
          "description": "Minimum minutes between rebalances."
        }
      }
    },
    "version": 4,
    "defaults": {
      "asset": "BTC",
      "platform": "hyperliquid",
      "schedule": {
        "cron": "*/30 * * * *",
        "enabled": false,
        "notifyEmail": false
      },
      "hedgeRatio": 1,
      "basisMaxBps": 50,
      "environment": "mainnet",
      "slippageBps": 20,
      "maxPerRunUsd": 1000,
      "perpLeverage": 1,
      "configVersion": 4,
      "deltaDriftPct": 2,
      "fundingMinBps": 0,
      "allocationMode": "target_notional",
      "perpLeverageMode": "cross",
      "targetNotionalUsd": 1000,
      "rebalanceCadenceMinutes": 30
    }
  },
  "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."
  }
}

Schedule

{
  "type": "cron",
  "expression": "*/30 * * * *",
  "notifyEmail": false,
  "authoredEnabled": false
}

Tool Path

tools/delta-neutral.js