Obelisk DEX - API Documentation

📊 Markets

GET /api/markets Get all available markets with real-time prices

Returns all trading pairs with current prices from Hyperliquid and dYdX.

Response

{
  "markets": [
    {
      "pair": "BTC/USDC",
      "price": 87828.50,
      "change24h": 2.34,
      "source": "Hyperliquid",
      "spread": 0.04
    }
  ],
  "count": 50,
  "realtime": true
}

Try It

GET /api/ticker/{pair} Get ticker for specific trading pair

Parameter	Type	Description
pair required	string	Trading pair (e.g., BTC/USDC)

Try It

GET /api/arbitrage Get cross-DEX arbitrage opportunities

Returns current arbitrage opportunities between Hyperliquid and dYdX.

Try It

🔐 Authentication

POST /api/auth/register Register bot/application for API access

Body Parameter	Type	Description
name required	string	Application name
type required	string	trading \| read-only \| analytics

Response

{
  "success": true,
  "apiKey": "obl_k_a1b2c3d4...",
  "secret": "obl_s_x9y8z7..."
}

POST /api/auth/session Create authenticated session

Requires X-API-Key header with your API key.

Body Parameter	Type	Description
ttlMinutes	integer	Session lifetime (default: 60, max: 1440)

📈 Trading

POST /api/order Place market or limit order

Requires authentication (API Key + Session).

Body Parameter	Type	Description
pair required	string	Trading pair (e.g., BTC/USDC)
side required	string	buy \| sell
quantity required	number	Amount to trade
type	string	market (default) \| limit
leverage	number	1-100 (default: 1)

GET /api/positions Get all open positions

Requires authentication. Returns all open positions with P&L.

🏦 Banking

POST /api/banking/deposit Prepare deposit to Obelisk

Parameter	Type	Description
amount	number	Amount to deposit (min: 10)
currency	string	USDC \| ETH \| USDT
network	string	ARBITRUM \| ETHEREUM \| POLYGON

POST /api/banking/withdraw Withdraw to external wallet

Instant withdrawals. No lock-up period.

💎 Investment Products

GET /api/products List all investment products

Available Products

[
  { "id": "safe-haven", "apy": "4-5%", "protection": 100% },
  { "id": "balanced", "apy": "7-10%", "protection": 90% },
  { "id": "yield", "apy": "10-15%", "protection": 80% },
  { "id": "growth", "apy": "12-18%", "protection": 70% }
]

POST /api/products/{id}/invest Invest in a product

Allocate funds to an investment product. Min investment: $10.