Skip to main content

Introduction

The OEMS (Order Execution Management System) provides a unified API for order execution across multiple cryptocurrency exchanges.

Features

  • Direct Execution - Execute market and limit orders on any supported exchange
  • Algorithmic Trading - TWAP, VWAP, and Iceberg execution algorithms
  • Pre-Trade Analysis - Balance checks, liquidity analysis, and slippage estimation
  • Transaction Cost Analysis - Post-trade execution quality metrics
  • Global Orderbook - Aggregated orderbook across exchanges with smart order routing

Supported Exchanges

ExchangeSpotPerpetualsNotes
BinanceYesYesPortfolio margin, hedge mode supported
BybitYesYesUnified account supported
Gate.ioYesYesStandard API
KrakenYesYesStandard API
HyperliquidNoYesWallet-based authentication

Authentication

All endpoints require a valid Bearer token. Include the token in the Authorization header:
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:8082/oems/execution/balance?exchange_account_id=your-account
In development mode (DEV_MODE=True), authentication is bypassed.

Daily Trading Limits

To prevent accidental large trades during development, each exchange account has a daily trading limit (default: $100/day). Check your remaining limit:
curl http://localhost:8082/oems/execution/daily-limit?exchange_account_id=your-account

Base URL

  • Development: http://localhost:8082
  • Production: Contact your administrator

Response Format

All responses follow this format:
{
  "isError": false,
  "message": "Success",
  "statusCode": 200,
  "data": { ... }
}
Error responses:
{
  "isError": true,
  "message": "Error description",
  "statusCode": 400,
  "data": {
    "error": "ERROR_CODE",
    "details": { ... }
  }
}