API Reference#

REST API and WebSocket documentation for the Seesaw indexer.

Trust model. The REST/WebSocket API is a convenience layer: it serves an off-chain database populated by the indexer from on-chain events. It is read-path infrastructure only — it never holds funds and cannot sign transactions — but its responses are only as fresh and as honest as the indexer that produced them (GET /api/v1/status reports freshness). Integrators who do not want to trust the indexer should use the Trustless SDK, which resolves and validates every account directly from any Solana RPC node, with no indexer in the trust path.

Section Map#

Base URL: https://api.seesaw.markets

Quick Orientation#

The examples below show the two most common first requests. For full parameter and response details, follow the links above.

# Fetch the current market (no auth required)
curl https://api.seesaw.markets/api/v1/markets/current

# Fetch the top of book (root-level endpoint, no /api prefix)
curl https://api.seesaw.markets/orderbook/top

// Subscribe to live market updates over WebSocket
const ws = new WebSocket('wss://api.seesaw.markets/ws');

ws.onopen = () => {
  ws.send(
    JSON.stringify({
      type: 'subscribe',
      channel: 'market:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    })
  );
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Update:', data);
};

See Also#

• Endpoints — public REST read endpoints
• Full REST Reference — authentication and authenticated endpoints
• WebSockets — real-time updates
• SDK Guide — trust-based client SDKs that consume this API
• Trustless SDK — integrate without trusting the indexer