| name | hyperliquid_tokenized_perps |
| description | 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). |
| when_to_use | A user asks to trade / quote / deploy on a tokenized perp on hyperliquid_perpetual and the plain pair can't be found or looks unavailable — typically equity or pre-IPO names (e.g. SPCX, and other stock-like tickers) rather than crypto majors. Triggers — "trade SPCX on hyperliquid", "can't find <TICKER>-USD on hyperliquid", "is <stock> available on hyperliquid perp"; ES — "no encuentro <TICKER>-USD en hyperliquid", "puedo operar <acción> en hyperliquid perp". |
| created | 2026-07-02T00:00:00.000Z |
| source | builtin |
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.
