Monitoring Guide: Safe Mode Operations

> ✅ 100% Safe — These operations require no authentication and cannot spend funds.

This guide covers read-only data access for monitoring 01.xyz markets, prices, and network status. Perfect for building dashboards, alerts, and market analysis tools.

Table of Contents

1. Public vs Private Endpoints
2. Market Information
3. Orderbook Data
4. Price & Stats
5. Funding Rates
6. Recent Trades
7. Code Examples
8. Rate Limits

---

Public vs Private Endpoints

Public Endpoints (No Auth Required)

These endpoints return data available to all users:

| Endpoint | Description | Cache Time | |----------|-------------|------------| | GET /info | All markets, specs, metadata | ~1 min | | GET /market/{id}/orderbook | Full L2 orderbook | Real-time | | GET /market/{id}/stats | 24h volume, funding rate, mark price | ~30 sec | | GET /trades | Recent public trades | Real-time | | GET /timestamp | Server timestamp | N/A |

Private Endpoints (Auth Required)

These require running the local API:

| Endpoint | Description | |----------|-------------| | GET /account/{address} | Account positions, balances | | GET /orders | Open orders for account | | GET /fills | Fill history |

---

Market Information

Get All Markets: /info

Returns complete list of trading markets with specifications.

Example Request:

curl https://zo-mainnet.n1.xyz/info | jq .

Example Response:

{
  "markets": [
    {
      "id": 0,
      "symbol": "BTCUSD",
      "name": "Bitcoin",
      "baseAsset": "BTC",
      "quoteAsset": "USD",
      "maxLeverage": 20,
      "minOrderSize": 0.001,
      "tickSize": 0.5,
      "maintenanceMargin": 0.05
    },
    {
      "id": 1,
      "symbol": "ETHUSD",
      "name": "Ethereum",
      "baseAsset": "ETH",
      "quoteAsset": "USD",
      "maxLeverage": 20,
      "minOrderSize": 0.01,
      "tickSize": 0.1,
      "maintenanceMargin": 0.05
    },
    {
      "id": 2,
      "symbol": "SOLUSD",
      "name": "Solana",
      "baseAsset": "SOL",
      "quoteAsset": "USD",
      "maxLeverage": 20,
      "minOrderSize": 0.1,
      "tickSize": 0.01,
      "maintenanceMargin": 0.05
    }
  ],
  "serverTime": 1738598400000
}

Key Fields:

| Field | Description | |-------|-------------| | id | Numeric market ID (required for all other calls) | | symbol | Human-readable symbol | | maxLeverage | Maximum allowed leverage | | tickSize | Minimum price increment | | maintenanceMargin | Liquidation threshold (e.g., 0.05 = 5%) |

---

Orderbook Data

Get Orderbook: /market/{id}/orderbook

Returns the full Level 2 orderbook for a given market.

Example Request:

curl https://zo-mainnet.n1.xyz/market/2/orderbook | jq .

Example Response:

{
  "marketId": 2,
  "symbol": "SOLUSD",
  "bids": [
    [145.00, 125.5],     // [price, size]
    [144.95, 300.0],
    [144.90, 150.0]
  ],
  "asks": [
    [145.02, 80.2],      // [price, size]
    [145.05, 200.0],
    [145.10, 500.0]
  ],
  "timestamp": 1738598400000
}

Important Notes:

• Prices are in USD
• Sizes are in base asset units (SOL, BTC, etc.)
• The spread = asks[0][0] - bids[0][0]
• Mid price = (bestBid + bestAsk) / 2

Orderbook Spread Analysis

function analyzeSpread(orderbook) {
  const bestBid = orderbook.bids[0][0];
  const bestAsk = orderbook.asks[0][0];
  const spread = bestAsk - bestBid;
  const midPrice = (bestBid + bestAsk) / 2;
  const spreadPct = (spread / midPrice) * 100;
  
  return {
    bestBid,
    bestAsk,
    spread,
    midPrice,
    spreadPct: spreadPct.toFixed(4) + '%'
  };
}

---

Price & Stats

Get Market Stats: /market/{id}/stats

Returns 24-hour statistics including mark price, index price, and funding rate.

Example Request:

curl https://zo-mainnet.n1.xyz/market/2/stats | jq .

Example Response:

{
  "marketId": 2,
  "symbol": "SOLUSD",
  "perpStats": {
    "mark_price": 145.23,
    "index_price": 145.20,
    "funding_rate": 0.0001,      // 0.01% per 8 hours
    "volume_24h": 12500000,      // USD
    "open_interest": 45000000,   // USD
    "change_24h": 0.0523,        // +5.23%
    "high_24h": 148.50,
    "low_24h": 138.20
  },
  "timestamp": 1738598400000
}

Key Fields:

| Field | Description | Use Case | |-------|-------------|----------| | mark_price | Current perpetual price | PnL calculation | | index_price | Spot index price | Fair value reference | | funding_rate | Next funding payment | Funding cost analysis | | open_interest | Total open positions | Market liquidity gauge | | change_24h | 24h price change | Trend analysis |

---

Funding Rates

Understanding Funding Rates

Funding rates are periodic payments between longs and shorts to keep perpetuals aligned with spot prices:

| Rate | Longs Pay | Shorts Pay | Market Bias | |------|-----------|------------|-------------| | Positive | Longs → Shorts | Receive | Long-dominant | | Negative | Receive | Shorts → Longs | Short-dominant |

• Frequency: Every 8 hours (00:00, 08:00, 16:00 UTC)
• Formula: Position Size × Mark Price × Funding Rate
• Impact: Can significantly affect PnL on longer holds

Fetch All Funding Rates

async function getAllFundingRates(baseUrl = 'https://zo-mainnet.n1.xyz') {
  // First get market list
  const info = await fetch(`${baseUrl}/info`).json();
  
  // Then fetch stats for each market
  const fundingData = await Promise.all(
    info.markets.map(async (market) => {
      const stats = await fetch(`${baseUrl}/market/${market.id}/stats`).json();
      return {
        symbol: market.symbol,
        marketId: market.id,
        fundingRate: stats.perpStats.funding_rate,
        markPrice: stats.perpStats.mark_price,
        annualizedRate: stats.perpStats.funding_rate * 3 * 365 // 3× daily × 365
      };
    })
  );
  
  return fundingData.sort((a, b) => b.fundingRate - a.fundingRate);
}

// Usage
const rates = await getAllFundingRates();
console.table(rates);

Sample Output:

┌─────────┬────────┬─────────────┬────────────┬─────────────────┐
│ (index) │ symbol │  marketId   │ fundingRate│ annualizedRate  │
├─────────┼────────┼─────────────┼────────────┼─────────────────┤
│    0    │ 'BTCUSD'│     0      │   0.0003   │     0.3285      │
│    1    │ 'SOLUSD'│     2      │   0.0001   │     0.1095      │
│    2    │ 'ETHUSD'│     1      │  -0.00005  │    -0.05475     │

---

Recent Trades

Get Public Trades: /trades

Returns recent public trades across all markets.

Query Parameters:

| Parameter | Type | Description | |-----------|------|-------------| | marketId | number | Filter by market | | limit | number | Max results (default: 100) | | startTime | timestamp | From time (ms) | | endTime | timestamp | To time (ms) |

Example:

curl 'https://zo-mainnet.n1.xyz/trades?marketId=2&limit=10' | jq .

Response:

{
  "trades": [
    {
      "id": "trade_12345",
      "marketId": 2,
      "price": 145.23,
      "size": 2.5,
      "side": "buy",       // Taker side
      "time": 1738598400000
    }
  ]
}

---

Code Examples

Example 1: Market Scanner

// monitor-markets.js
// Scans all markets and displays key metrics

const BASE_URL = 'https://zo-mainnet.n1.xyz';

...