[new-plugin] hl-instant-order v1.0.0

[JarviYin]

Plugin Submission

Plugin name: hl-instant-order
Version: 1.0.0
Type: new-plugin

Checklist

• My plugin does NOT use reserved prefixes (okx-, official-, plugin-store-)
• LICENSE file is included (MIT)
• SKILL.md has YAML frontmatter with name and description
• I have read the Development Guide
• plugin-store lint passes locally — Cargo not available in dev environment, relying on CI lint. File-size, frontmatter, schema, and --strategy-id coverage manually verified.

What does this plugin do?

Turns one natural-language sentence into one bracketed Hyperliquid perpetual order. The AI agent parses coin/side/size/leverage/SL/TP from the user's message, previews the exact hyperliquid order command, and on explicit user confirmation submits it via OnchainOS Agentic Wallet — entry, stop-loss, and take-profit all signed atomically as a single OCO bracket (grouping: normalTpsl).

Strategy attribution: every write-op example uses --strategy-id hl-instant-order so trades are recorded for the Plugin Store leaderboard.

Which onchainos commands does it use?

Read-only:

• onchainos wallet status
• onchainos wallet addresses

Through hyperliquid-plugin (declared as dependent_plugin):

• hyperliquid prices (read)
• hyperliquid quickstart (read)
• hyperliquid positions (read)
• hyperliquid register (one-time setup)
• hyperliquid order — write, always with --strategy-id hl-instant-order and user --confirm
• hyperliquid tpsl — write, same constraints
• hyperliquid close — write, same constraints

Security Considerations

• Risk level: standard. Every write op requires explicit per-call user --confirm after preview; no autonomous trading.
• No private keys handled — all signing routes through OnchainOS Agentic Wallet TEE.
• Data trust boundary documented in SKILL.md — Hyperliquid API responses treated as untrusted external content.
• Liquidation / leverage risk disclaimer included.
• Validation rules (SL below mid for longs, etc.) gated client-side before the binary is invoked.
• Strategy-id mandatory — declared in SKILL.md as a CI-enforced rule; every write-op example carries the flag.

Testing

• File structure, schema, and frontmatter validated against the dev-guide template and existing trading-strategy plugins (e.g. smart-money-signal-copy-trade) in this repo.
• All 5 examples + the tpsl and close follow-ups confirmed to include --strategy-id hl-instant-order (11 occurrences in SKILL.md).
• File sizes well under the 200KB / 5MB limits (largest file: SKILL.md at 11.8KB).
• dependent_plugin: hyperliquid-plugin ^0.3.9 resolves against the current registry.json (v0.3.9 is the latest published version with bracket OCO + strategy attribution).
• Live execution against the OnchainOS Agentic Wallet on Hyperliquid pending — will verify with a small real-funds round-trip after merge.

Notes

This plugin and the companion hl-grid-batch (separate PR) are submissions for the Plugin Store Season 1 Developer Challenge (Apr 23 – May 7, 2026).