Skip to main content

​
Wallets

​
GET /api/hyperliquid/wallets

List Hyperliquid wallets for the current user’s accounts. Example request 
curl https://api.hyperoru.com/api/hyperliquid/wallets
Example response 
[
  { "account_id": 1, "address": "0xabc...", "environment": "testnet", "balance": 5000.0 }
]

​
All wallets

​
GET /api/hyperliquid/wallets/all

List all Hyperliquid wallets across all users. Example request 
curl https://api.hyperoru.com/api/hyperliquid/wallets/all
Example response 
[
  { "account_id": 1, "address": "0xabc...", "environment": "testnet" }
]

​
Positions

​
GET /api/hyperliquid/positions

List all open positions across Hyperliquid accounts. Example request 
curl https://api.hyperoru.com/api/hyperliquid/positions
Example response 
[
  { "account_id": 1, "symbol": "BTC", "side": "long", "size": 0.05, "entry_price": 67000.0, "unrealized_pnl": 75.0 }
]

​
Account state

​
GET /api/hyperliquid/account//state

Get the full Hyperliquid account state.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/account/1/state
Example response 
{
  "account_id": 1,
  "equity": 10000.0,
  "margin_used": 3350.0,
  "free_collateral": 6650.0,
  "positions": []
}

​
Setup

​
POST /api/hyperliquid/accounts//setup

Set up Hyperliquid integration for an account.
​
account_id
integer
required
Account ID.
​
private_key
string
required
Wallet private key.
​
environment
string
testnet or mainnet. Defaults to testnet.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/setup \
  -H "Content-Type: application/json" \
  -d '{"private_key": "0x...", "environment": "testnet"}'
Example response 
{
  "status": "ok",
  "address": "0xabc..."
}

​
Switch environment

​
POST /api/hyperliquid/accounts//switch-environment

Switch between testnet and mainnet.
​
account_id
integer
required
Account ID.
​
environment
string
required
testnet or mainnet.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/switch-environment \
  -H "Content-Type: application/json" \
  -d '{"environment": "mainnet"}'
Example response 
{
  "status": "ok"
}

​
Config

​
GET /api/hyperliquid/accounts//config

Get the Hyperliquid configuration for an account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/config
Example response 
{
  "account_id": 1,
  "environment": "testnet",
  "address": "0xabc...",
  "leverage": 5
}

​
Balance

​
GET /api/hyperliquid/accounts//balance

Get the account balance on Hyperliquid.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/balance
Example response 
{
  "equity": 10000.0,
  "available_balance": 6650.0
}

​
Account positions

​
GET /api/hyperliquid/accounts//positions

List positions for a specific account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/positions
Example response 
[
  { "symbol": "BTC", "side": "long", "size": 0.05, "entry_price": 67000.0 }
]

​
Manual order

​
POST /api/hyperliquid/accounts//orders/manual

Place a manual order on Hyperliquid.
​
account_id
integer
required
Account ID.
​
symbol
string
required
Symbol.
​
side
string
required
buy or sell.
​
size
number
required
Order size.
​
price
number
Limit price. Omit for market order.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/orders/manual \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTC", "side": "buy", "size": 0.01}'
Example response 
{
  "status": "ok",
  "order_id": "hl-order-001"
}

​
Disable / Enable trading

​
POST /api/hyperliquid/accounts//disable

​
POST /api/hyperliquid/accounts//enable

​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/disable
Example response 
{
  "status": "ok"
}

​
Test connection

​
GET /api/hyperliquid/accounts//test-connection

Test the Hyperliquid API connection for an account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/test-connection
Example response 
{
  "connected": true,
  "latency_ms": 120
}

​
Snapshots

​
GET /api/hyperliquid/accounts//snapshots

Get historical account state snapshots.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/snapshots
Example response 
[
  { "timestamp": "2026-04-09T00:00:00Z", "equity": 10000.0, "positions_count": 2 }
]

​
Rate limit

​
GET /api/hyperliquid/accounts//rate-limit

Check current rate limit status for the account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/rate-limit
Example response 
{
  "requests_used": 45,
  "requests_limit": 100,
  "reset_at": "2026-04-09T12:01:00Z"
}

​
Trading stats

​
GET /api/hyperliquid/accounts//trading-stats

Get trading statistics for the account on Hyperliquid.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/trading-stats
Example response 
{
  "total_trades": 42,
  "total_volume": 125000.0,
  "total_pnl": 2500.0
}

​
Wallet CRUD

​
GET /api/hyperliquid/accounts//wallet

​
POST /api/hyperliquid/accounts//wallet

​
DELETE /api/hyperliquid/accounts//wallet

Get, create, or delete the Hyperliquid wallet for an account.
​
account_id
integer
required
Account ID.
Example request (GET) 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/wallet
Example response 
{
  "address": "0xabc...",
  "environment": "testnet",
  "is_agent": false
}

​
Test wallet

​
POST /api/hyperliquid/accounts//wallet/test

Test the wallet connection.
​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/wallet/test
Example response 
{
  "status": "ok",
  "balance": 5000.0
}

​
Upgrade to agent wallet

​
POST /api/hyperliquid/accounts//wallet/upgrade-to-agent

Upgrade the wallet to an agent wallet for automated trading.
​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/wallet/upgrade-to-agent
Example response 
{
  "status": "ok",
  "agent_address": "0xdef..."
}

​
Create agent wallet

​
POST /api/hyperliquid/accounts//wallet/agent

Create a new agent wallet.
​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/hyperliquid/accounts/1/wallet/agent
Example response 
{
  "status": "ok",
  "agent_address": "0xdef..."
}

​
Agent status

​
GET /api/hyperliquid/accounts//wallet/agent-status

Check the agent wallet status.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/hyperliquid/accounts/1/wallet/agent-status
Example response 
{
  "is_agent": true,
  "agent_address": "0xdef...",
  "authorized": true
}

​
Available symbols

​
GET /api/hyperliquid/symbols/available

List all tradable symbols on Hyperliquid. Example request 
curl https://api.hyperoru.com/api/hyperliquid/symbols/available
Example response 
{
  "symbols": ["BTC", "ETH", "SOL", "ARB", "DOGE", "WIF"]
}

​
Watchlist

​
GET /api/hyperliquid/symbols/watchlist

​
PUT /api/hyperliquid/symbols/watchlist

Get or update the Hyperliquid symbol watchlist. Example request (PUT) 
curl -X PUT https://api.hyperoru.com/api/hyperliquid/symbols/watchlist \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["BTC", "ETH", "SOL"]}'
Example response 
{
  "symbols": ["BTC", "ETH", "SOL"]
}

​
Actions summary

​
GET /api/hyperliquid/actions/summary

Get a summary of recent Hyperliquid exchange actions. Example request 
curl https://api.hyperoru.com/api/hyperliquid/actions/summary
Example response 
{
  "total_actions": 150,
  "by_type": { "order": 100, "cancel": 30, "transfer": 20 }
}

​
Exchange actions

​
GET /api/hyperliquid/actions/

List recent exchange actions with details. Example request 
curl https://api.hyperoru.com/api/hyperliquid/actions/
Example response 
[
  { "type": "order", "symbol": "BTC", "side": "buy", "size": 0.01, "timestamp": "2026-04-09T10:00:00Z" }
]

​
Health

​
GET /api/hyperliquid/health

Check the Hyperliquid integration health. Example request 
curl https://api.hyperoru.com/api/hyperliquid/health
Example response 
{
  "status": "ok",
  "api_reachable": true,
  "latency_ms": 85
}

​
Trading mode

​
GET /api/hyperliquid/trading-mode

​
POST /api/hyperliquid/trading-mode

Get or set the global trading mode. Example request (POST) 
curl -X POST https://api.hyperoru.com/api/hyperliquid/trading-mode \
  -H "Content-Type: application/json" \
  -d '{"mode": "paper"}'
Example response 
{
  "mode": "paper"
}

​
Wallet upgrade check

​
GET /api/hyperliquid/wallet-upgrade-check

Check if any wallets need upgrading to agent wallets. Example request 
curl https://api.hyperoru.com/api/hyperliquid/wallet-upgrade-check
Example response 
{
  "needs_upgrade": [
    { "account_id": 2, "address": "0xghi...", "reason": "No agent wallet configured" }
  ]
}