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

# OEMS API

> Order Execution Management System API Documentation

# 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

| Exchange    | Spot | Perpetuals | Notes                                                                                        |
| ----------- | ---- | ---------- | -------------------------------------------------------------------------------------------- |
| Binance     | Yes  | Yes        | Portfolio margin, hedge mode supported                                                       |
| Bybit       | Yes  | Yes        | Unified account supported                                                                    |
| Gate.io     | Yes  | Yes        | Standard API                                                                                 |
| Kraken      | Yes  | Yes        | Spot and Futures use **separate API keys**, see [Trading on Kraken](/oems-api/guides/kraken) |
| OKX         | Yes  | Yes        | Unified account supported                                                                    |
| Hyperliquid | No   | Yes        | Wallet-based authentication                                                                  |

## Authentication

All REST endpoints authenticate with a Renesis **API key** (prefix `ak_`), passed in the `X-API-Key` header. Create and manage keys from your user page in the [dashboard](https://terminal.renesis.fi); the secret is shown only once at creation, so copy it then.

```bash theme={null}
export API_KEY="ak_xxxxxxxxxxxxxxxxxxxx"

curl -H "X-API-Key: $API_KEY" \
  "https://api.renesis.fi/order-execution/execution/balance?exchange_account_id=your-account"
```

The key works on every route until you revoke it, with no login or session to keep alive. If a key was issued with a path allowlist, it must include the `/order-execution` prefix to call OEMS endpoints. Keep keys secret and server-side.

## 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:

```bash theme={null}
curl -H "X-API-Key: $API_KEY" \
  "https://api.renesis.fi/order-execution/execution/daily-limit?exchange_account_id=your-account"
```

## Base URL

* **Production:** `https://api.renesis.fi`

All OEMS endpoints are served under the `/order-execution` prefix. For other environments, contact your administrator.

## Response Format

All responses follow this format:

```json theme={null}
{
  "isError": false,
  "message": "Success",
  "statusCode": 200,
  "data": { ... }
}
```

Error responses:

```json theme={null}
{
  "isError": true,
  "message": "Error description",
  "statusCode": 400,
  "data": {
    "error": "ERROR_CODE",
    "details": { ... }
  }
}
```