> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tide.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete API reference for Tide endpoints

# Tide API Reference

Welcome to the Tide API reference documentation. This section provides detailed information about all available endpoints, organized by functionality.

## Base URL

All API requests should be made to:

```
https://api.tide.ag
```

<Note>
  **Public API:** The Tide API is currently open. You can call `https://api.tide.ag` without creating dashboard API keys or sending Tide authentication headers. Trading and account flows still use **exchange-specific** credentials (for example Lighter API keys or a registered server wallet) where documented on each endpoint.
</Note>

## Authentication

You do **not** need Tide dashboard API keys to access the API server today.

When signed requests are enabled for the Tide API, private endpoints will expect HTTP headers like:

```bash theme={null}
X-API-KEY: your_api_key
X-API-SECRET: your_api_secret
X-API-TIMESTAMP: unix_timestamp_ms
X-API-SIGNATURE: hmac_sha256_signature
```

<Card title="Tide Dashboard" icon="layout-dashboard" href="https://app.tide.ag/">
  Optional: open the app for wallets, monitoring, and future API access controls
</Card>

## Supported Exchanges

Tide aggregates data and routes orders across these exchanges:

<CardGroup cols={2}>
  <Card title="Hyperliquid">
    <img src="https://mintcdn.com/arcane-0ded8dd0/z4C1e-4U8Br-9RtW/brand-logos/hyperliquid.svg?fit=max&auto=format&n=z4C1e-4U8Br-9RtW&q=85&s=1ad5de358eaa312c1d6fdb95a1b58513" alt="Hyperliquid" className="h-9 w-auto max-w-[200px] object-contain object-left mb-3" draggable={false} width="1132" height="177" data-path="brand-logos/hyperliquid.svg" />

    High-performance perpetual DEX
  </Card>

  <Card title="Aster">
    <img src="https://mintcdn.com/arcane-0ded8dd0/z4C1e-4U8Br-9RtW/brand-logos/aster.svg?fit=max&auto=format&n=z4C1e-4U8Br-9RtW&q=85&s=d08dd00450ec05569ecc211d529c82a3" alt="Aster" className="h-9 w-auto max-w-[200px] object-contain object-left mb-3" draggable={false} width="667" height="177" data-path="brand-logos/aster.svg" />

    Cross-chain perpetual trading
  </Card>

  <Card title="Lighter">
    <img src="https://mintcdn.com/arcane-0ded8dd0/z4C1e-4U8Br-9RtW/brand-logos/lighter.svg?fit=max&auto=format&n=z4C1e-4U8Br-9RtW&q=85&s=735b3ff9aa3cf3337e84b6db8249825f" alt="Lighter" className="h-9 w-auto max-w-[200px] object-contain object-left mb-3" draggable={false} width="550" height="177" data-path="brand-logos/lighter.svg" />

    Orderbook-based DEX
  </Card>

  <Card title="Pacifica">
    <img src="https://mintcdn.com/arcane-0ded8dd0/z4C1e-4U8Br-9RtW/brand-logos/pacifica.svg?fit=max&auto=format&n=z4C1e-4U8Br-9RtW&q=85&s=bcbc3cc892c9ab3ab2f3d25f2de93897" alt="Pacifica" className="h-9 w-auto max-w-[200px] object-contain object-left mb-3" draggable={false} width="643" height="177" data-path="brand-logos/pacifica.svg" />

    Advanced DEX on Solana
  </Card>

  <Card title="Avantis">
    <img src="https://mintcdn.com/arcane-0ded8dd0/z4C1e-4U8Br-9RtW/brand-logos/avantis.svg?fit=max&auto=format&n=z4C1e-4U8Br-9RtW&q=85&s=2c7cbb2711d19e9b389d0e8bf4b8b783" alt="Avantis" className="h-9 w-auto max-w-[200px] object-contain object-left mb-3" draggable={false} width="960" height="177" data-path="brand-logos/avantis.svg" />

    Perpetual trading on Base
  </Card>
</CardGroup>

## Rate Limits

* **Public endpoints**: 100 requests per minute
* **Private endpoints**: 60 requests per minute
* **WebSocket connections**: 5 simultaneous connections per client

## Response Format

All API responses follow a consistent JSON format with proper HTTP status codes. Errors include detailed information to help with debugging.

<Note>
  For real-time data, consider using our [WebSocket API](/websocket) instead of polling REST endpoints.
</Note>
