How do I install the Hyperliquid Tokenized Perps skill?

Run npx skillmds@latest add hummingbot/hyperliquid-tokenized-perps in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hyperliquid Tokenized Perps safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hyperliquid Tokenized Perps?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hyperliquid Tokenized Perps free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hyperliquid Tokenized Perps?

hummingbot (@hummingbot) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hyperliquid Tokenized Perps by hummingbot

Name: Hyperliquid Tokenized Perps
Author: hummingbot

Hyperliquid Tokenized Perps

On hyperliquid_perpetual, tokenized perp contracts (equities/pre-IPO names like SPCX-USD) are issued by a provider and require an issuer prefix in the trading pair (e.g. XYZ:SPCX-USD, not SPCX-USD).

hummingbot 31a3098 2.9 KB Updated Sep 17, 2026

File contents

On hyperliquid_perpetual, tokenized perpetual contracts (equities / pre-IPO names such as SPCX-USD) are not listed directly. They are issued by a provider, and the issuer's prefix is part of the trading pair symbol.

The rule

Prepend the issuer prefix to the pair, UPPERCASE:

XYZ:SPCX-USD      ✅ correct
xyz:SPCX-USD      ❌ KeyError at trade time (see below)
SPCX-USD          ❌ not found

The biggest issuer is XYZ, so XYZ: is the default prefix to try.

Case matters — use UPPERCASE, and don't trust the price endpoint

The issuer prefix must be uppercase (XYZ:, not xyz:). The exchange returns the symbol lowercase (xyz:SPCX), but the connector builds its trading-pair symbol map by uppercasing it — the canonical hummingbot pair is XYZ:SPCX-USD. A lowercase pair is not in the map, so exchange_symbol_associated_to_pair throws KeyError, the order-book subscription fails on a loop, and a deployed bot silently stops without placing a single order.

⚠️ The market-data/prices and candles endpoints accept BOTH cases and return the same price — that layer normalizes case. This is a FALSE "case-insensitive" signal. Do NOT use a successful price/candle lookup to conclude lowercase is fine. Only the actual trading connector's symbol map is authoritative, and it is case-sensitive. Always deploy / quote / order with the uppercase XYZ:<TICKER>-USD. (Learned the hard way 2026-07-23: a lowercase deploy passed the price check, then KeyError-looped and never quoted; the prior working run used XYZ:SPCX-USD and filled cleanly.)

When to apply

When a user asks to trade a tokenized perp on hyperliquid_perpetual and the plain pair (e.g. SPCX-USD) can't be found:

Check whether the underlying is a tokenized asset (equity / pre-IPO ticker, not a native crypto).
If so, retry with the issuer prefix — uppercase XYZ:<TICKER>-USD by default — before concluding the pair is unavailable.
Only report "not available on hyperliquid_perpetual" after the prefixed form also fails.

This applies anywhere a hyperliquid perp pair is resolved — quoting, placing an order, or deploying an executor/controller. Use the uppercase prefix everywhere, including the controller config and bot deploy.

Operating rule (host deployments)

Condor's agents/ tree, skills/, and root store/ are its runtime state. Operate Condor ONLY via the mcp__condor__* tools — never by reading or editing those files directly. If the Condor MCP server is not connected, tell the user to connect it instead of improvising against the filesystem.

---name: hyperliquid-tokenized-perpsdescription: On hyperliquid_perpetual, tokenized perp contracts (equities/pre-IPO names like SPCX-USD) are issued by a provider and require an issuer prefix in the trading pair (e.g. XYZ:SPCX-USD, not SPCX-USD).---On `hyperliquid_perpetual`, **tokenized perpetual contracts** (equities / pre-IPOnames such as `SPCX-USD`) are **not listed directly**. They are issued by aprovider, and the issuer's prefix is part of the trading pair symbol.## The rulePrepend the issuer prefix to the pair, **UPPERCASE**:```XYZ:SPCX-USD ✅ correctxyz:SPCX-USD ❌ KeyError at trade time (see below)SPCX-USD ❌ not found```The biggest issuer is **XYZ**, so `XYZ:` is the default prefix to try.## Case matters — use UPPERCASE, and don't trust the price endpointThe issuer prefix **must be uppercase** (`XYZ:`, not `xyz:`). The exchange returns thesymbol lowercase (`xyz:SPCX`), but the connector builds its trading-pair symbol map byuppercasing it — the canonical hummingbot pair is `XYZ:SPCX-USD`. A lowercase pair is**not** in the map, so `exchange_symbol_associated_to_pair` throws `KeyError`, theorder-book subscription fails on a loop, and a deployed bot silently stops **withoutplacing a single order**.⚠️ **The `market-data/prices` and `candles` endpoints accept BOTH cases and return thesame price** — that layer normalizes case. This is a FALSE "case-insensitive" signal. DoNOT use a successful price/candle lookup to conclude lowercase is fine. Only the actualtrading connector's symbol map is authoritative, and it is **case-sensitive**. Alwaysdeploy / quote / order with the **uppercase** `XYZ:<TICKER>-USD`. (Learned the hard way2026-07-23: a lowercase deploy passed the price check, then KeyError-looped and neverquoted; the prior working run used `XYZ:SPCX-USD` and filled cleanly.)## When to applyWhen a user asks to trade a tokenized perp on `hyperliquid_perpetual` and theplain pair (e.g. `SPCX-USD`) can't be found:1. Check whether the underlying is a **tokenized asset** (equity / pre-IPO ticker, not a native crypto).2. If so, retry with the issuer prefix — **uppercase** `XYZ:<TICKER>-USD` by default — **before** concluding the pair is unavailable.3. Only report "not available on hyperliquid_perpetual" after the prefixed form also fails.This applies anywhere a hyperliquid perp pair is resolved — quoting, placing anorder, or deploying an executor/controller. Use the uppercase prefix everywhere,including the controller config and bot deploy.## Operating rule (host deployments)Condor's `agents/` tree, `skills/`, and root `store/` are its runtime state. OperateCondor ONLY via the `mcp__condor__*` tools — never by reading or editingthose files directly. If the Condor MCP server is not connected, tell theuser to connect it instead of improvising against the filesystem.

Frequently asked questions