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 for implementation examples.

Response Format

All HTTP responses follow this envelope:

{ "ok": true, "data": { ... } }
{ "ok": false, "error": "ErrorCode", "message": "Human readable detail" }

Related Pages

HTTP API

Complete endpoint reference with request/response schemas.

WebSocket Feeds

Real-time orderbook, trades, and private account feeds.

Authentication

How to sign orders and authenticate WebSocket connections.

Errors

Error codes and how to handle them.