API Reference

Rubicon markets are accessible via Hyperliquid's API infrastructure. This page documents how to interact programmatically.

Overview

Rubicon perpetuals trade on Hyperliquid's infrastructure. You interact via Hyperliquid's API:

Component	Endpoint
REST API	https://api.hyperliquid.xyz
WebSocket	wss://api.hyperliquid.xyz/ws
Info API	https://api.hyperliquid.xyz/info

Authentication

Trading operations require signing with your wallet's private key. Read operations are public.

import { ethers } from "ethers";

const wallet = new ethers.Wallet(PRIVATE_KEY);

async function signRequest(action) {
  const message = JSON.stringify(action);
  const signature = await wallet.signMessage(message);
  return { action, signature };
}

Market Identifiers

Rubicon markets use Hyperliquid's asset indexing:

Asset	Symbol	Hyperliquid Index
SOXX	SOXX-PERP	Check via info endpoint
KODEX	KODEX-PERP	Check via info endpoint

Get Asset Index

// Get all tradeable assets
const response = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ type: "meta" })
});

const meta = await response.json();
const assets = meta.universe;

// Find SOXX index
const soxx = assets.find(a => a.name === "SOXX");
console.log(soxx.assetId);  // Use this for orders

REST Endpoints

Get Market Data

// Get order book
const orderbook = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "l2Book",
    coin: "SOXX"
  })
});

Response:

{
  "levels": [
    [
      [["225.00", "10.5"], ["224.99", "5.2"]],   // bids
      [["225.01", "8.3"], ["225.02", "12.1"]]    // asks
    ]
  ]
}

Get User Positions

const positions = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "clearinghouseState",
    user: "0xYourAddress"
  })
});

Place Order

const orderAction = {
  type: "order",
  orders: [{
    a: SOXX_ASSET_ID,    // Asset ID
    b: true,              // true = buy, false = sell
    p: "225.00",          // Price
    s: "10",              // Size
    r: false,             // Reduce only
    t: {
      limit: {
        tif: "Gtc"        // Good til cancelled
      }
    }
  }],
  grouping: "na"
};

const signedOrder = await signRequest(orderAction);
const response = await fetch("https://api.hyperliquid.xyz/exchange", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(signedOrder)
});

Cancel Order

const cancelAction = {
  type: "cancel",
  cancels: [{
    a: SOXX_ASSET_ID,
    o: ORDER_ID
  }]
};

const signedCancel = await signRequest(cancelAction);
// Submit to /exchange endpoint

Common Operations

Get Oracle Price

const info = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "allMids"
  })
});

const mids = await info.json();
console.log(mids["SOXX"]);  // "225.00"

Get Funding Rate

const funding = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "fundingHistory",
    coin: "SOXX",
    startTime: Date.now() - 86400000  // Last 24h
  })
});

Get Recent Trades

const trades = await fetch("https://api.hyperliquid.xyz/info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "recentTrades",
    coin: "SOXX"
  })
});

Error Handling

API errors return:

{
  "status": "err",
  "response": "Error message here"
}

Common errors:

Error	Meaning	Action
Invalid signature	Auth failed	Check signing
Insufficient margin	Need more funds	Deposit or reduce size
Price out of bounds	Order too far from mark	Adjust price
Rate limited	Too many requests	Slow down

Rate Limits

Endpoint	Limit
Info queries	100/second
Order placement	10/second
Cancellations	100/second

SDKs

JavaScript/TypeScript

Rubicon uses the @nktkas/hyperliquid SDK for all Hyperliquid interactions.

npm install @nktkas/hyperliquid

import { InfoClient, ExchangeClient, HttpTransport } from "@nktkas/hyperliquid";

// Create info client for read operations
const transport = new HttpTransport({ timeout: 10000 });
const infoClient = new InfoClient({ transport });

// Get market data
const mids = await infoClient.allMids();
const orderBook = await infoClient.l2Book({ coin: "rub:SOXX" });

// For trading, create exchange client with wallet
const exchangeClient = new ExchangeClient({ transport, wallet });
await exchangeClient.order(orderParams);

Python

pip install hyperliquid-python-sdk

from hyperliquid import HyperliquidClient

client = HyperliquidClient(private_key)

# Get positions
positions = client.get_positions()

# Place order
client.place_order("SOXX", "buy", size=10, price=225.00)

Example: Simple Trading Bot

import { InfoClient, ExchangeClient, HttpTransport } from "@nktkas/hyperliquid";

const transport = new HttpTransport({ timeout: 10000 });
const infoClient = new InfoClient({ transport });

async function run() {
  // Get SOXX price
  const mids = await infoClient.allMids();
  const price = parseFloat(mids["rub:SOXX"]);
  console.log(`SOXX: $${price}`);

  // Get order book
  const book = await infoClient.l2Book({ coin: "rub:SOXX" });
  console.log(`Best bid: ${book.levels[0][0].px}`);

  // For trading, you'd create an ExchangeClient with your wallet
  // const exchangeClient = new ExchangeClient({ transport, wallet });
  // await exchangeClient.order({ ... });
}

run();

Next Steps

• WebSocket Feeds — Real-time data streaming

• HIP-3 Protocol — Understanding the oracle system

• Hyperliquid Docs — Full API reference