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

# API Overview

> Vela Exchange HTTP and WebSocket API reference

## Base URL

```
https://vela-engine.fly.dev
```

## Endpoints Summary

| Category     | Endpoints                                                        |
| ------------ | ---------------------------------------------------------------- |
| Markets      | `GET /markets`, `GET /orderbook/:id`, `GET /ohlcv/:id`           |
| Orders       | `POST /orders`, `POST /orders/cancel`                            |
| Account      | `GET /account/:address/balances`, `GET /account/:address/orders` |
| Fees         | `GET /fees`, `GET /markets/:id/fees`                             |
| Referrals    | `GET /referral/:address`, `POST /referral/register`              |
| Leaderboard  | `GET /leaderboard`                                               |
| Transparency | `GET /orders/:id/da-proof`, `POST /force-include`                |
| WebSocket    | `wss://vela-engine.fly.dev/ws`                                   |

## Authentication

Order mutations (place, cancel) require an Ethereum wallet signature using `personal_sign` (EIP-191). WebSocket private feeds use a separate timestamp-based auth signature.

See [Authentication](/api-reference/authentication) for implementation examples.

## Response Format

All HTTP responses follow this envelope:

```json theme={null}
{ "ok": true, "data": { ... } }
{ "ok": false, "error": "ErrorCode", "message": "Human readable detail" }
```

## Related Pages

<CardGroup cols={2}>
  <Card title="HTTP API" icon="code" href="/api-reference/http">
    Complete endpoint reference with request/response schemas.
  </Card>

  <Card title="WebSocket Feeds" icon="bolt" href="/transparency/websocket">
    Real-time orderbook, trades, and private account feeds.
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    How to sign orders and authenticate WebSocket connections.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/api-reference/errors">
    Error codes and how to handle them.
  </Card>
</CardGroup>