Overview

The RWA (Real World Assets) vertical provides access to tokenized stocks, commodities, and custom assets deployed as HIP-3 dexes on Hyperliquid. Each HIP-3 dex is an independent perp market deployed by a partner with their own set of listed assets.
RWA markets are currently available on Hyperliquid only. They use the same order format as perps.

How HIP-3 Dexes Work

A HIP-3 dex is a custom perpetual futures exchange deployed on Hyperliquid L1. Each dex:
  • Has its own set of listed markets (e.g., AAPL, TSLA, GOLD)
  • Uses oracle-based pricing for settlement
  • Supports custom leverage, margin, and fee parameters
  • Is managed by a deployer who can add assets, set oracles, and configure risk params

Step 1: Discover Available Dexes

curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/rwas/hyperliquid/dexes | jq
Response:
[
  {
    "name": "stocksPerp",
    "deployer": "0xabc...",
    "marketCount": 12,
    "description": "Tokenized US equities"
  },
  {
    "name": "commodities",
    "deployer": "0xdef...",
    "marketCount": 5,
    "description": "Gold, Silver, Oil, and more"
  }
]

Step 2: Browse Markets

List all RWA markets, optionally filtered by dex:
# All RWA markets
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/rwas/hyperliquid/markets | jq

# Markets for a specific dex
curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/rwas/hyperliquid/markets?dex=stocksPerp" | jq

Step 3: Get Market Data

RWA markets support the same data endpoints as perps:
curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/rwas/hyperliquid/orderbook/AAPL?dex=stocksPerp&depth=10" | jq

Step 4: Trade RWA Perps

Trading is identical to regular perps — the same order format and wallet signing:
curl -X POST -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  https://api.perps.studio/v1/rwas/hyperliquid/orders \
  -d '{
    "symbol": "AAPL",
    "side": "buy",
    "type": "limit",
    "size": "1",
    "price": "195.50",
    "wallet": "0xYourWallet",
    "signature": "0x...",
    "nonce": 1712000000000
  }'

Step 5: Check Positions

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/rwas/hyperliquid/positions/0xYourWallet?dex=stocksPerp" | jq

For Dex Deployers: Admin Actions

If you are a HIP-3 dex deployer, the Provider API exposes admin endpoints for managing your dex:
EndpointDescription
POST /rwas/:provider/admin/register-assetRegister a new asset on your dex
POST /rwas/:provider/admin/set-oracleSet/update oracle configuration
POST /rwas/:provider/admin/set-fundingConfigure funding rate multipliers
POST /rwas/:provider/admin/haltHalt trading on the dex
POST /rwas/:provider/admin/set-oi-capsSet open interest caps
POST /rwas/:provider/admin/set-fee-recipientChange fee recipient address
POST /rwas/:provider/admin/set-marginSet margin table IDs
Admin actions require the deployer wallet signature. These actions affect all traders on your dex — use with caution.

Dex Financial Status

Check the health and financial metrics of a dex:
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/rwas/hyperliquid/dexes/stocksPerp/status | jq

Asset Categories

Hyperliquid categorizes RWA assets. Fetch categories to build filtered UIs:
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/rwas/hyperliquid/categories | jq