API VERSION 1.4.2 // PROD

Institutional Connectivity

Die EZ INVEST API bietet direkten Marktzugang (DMA) zu unserer High-Frequency Matching Engine. Unsere Infrastruktur ist für institutionelle Anforderungen optimiert und bietet deterministische Latenzzeiten durch FPGA-beschleunigtes Order-Routing.

Alle Schnittstellen befinden sich in Co-Location zu den primären Liquiditätsquellen, um "Tick-to-Trade"-Latenzen unter 5 Mikrosekunden (µs) zu gewährleisten.

🔒

Security Requirement

Alle Endpunkte erzwingen TLS 1.3. Unverschlüsselte Verbindungen oder veraltete Cipher-Suites werden auf Gateway-Ebene ohne Response terminiert.

Authentication

Der Zugriff auf private Endpunkte erfordert eine HMAC-SHA256 Signatur. Dies stellt die Integrität und Authentizität jeder Anfrage sicher.

Required Headers

Header	Format / Description
X-EZ-KEY	Ihr 32-stelliger Public API Key.
X-EZ-SIGN	Hex-codierter HMAC-SHA256 Hash des Request-Payloads.
X-EZ-TIMESTAMP	Unix Timestamp in Sekunden oder Millisekunden. Dient als Replay-Schutz.

EXAMPLE REQUEST BASH / CURL

curl -X GET "https://api.ez-invest.de/v1/account" \
  -H "X-EZ-KEY: {YOUR_API_KEY}" \
  -H "X-EZ-SIGN: {HMAC_SIGNATURE}" \
  -H "X-EZ-TIMESTAMP: 1614512400"

* Zeitstempel, die mehr als 5000µs vom Server-Clock abweichen, führen zu einem `401 INVALID_TIMESTAMP` Fehler.

Rate Limits & SLAs

Wir verwenden einen Token Bucket Algorithmus zur Laststeuerung. Limits werden auf API-Key Ebene aggregiert.

Account Tier	REST Limit	WebSocket
Standard	50 req/s	5 topics
Institutional	2,500 req/s	Unlimited
Cross-Connect	Unlimited	Multicast HF

ℹ️

Limit Headers

Jede Response enthält Header wie X-RateLimit-Limit und X-RateLimit-Remaining, die Ihre aktuelle Quote in Echtzeit widerspiegeln.

Order Management

Das Order Management System (OMS) unterstützt Standard- und algorithmische Order-Typen. Aufträge werden direkt in den FPGA-Memory-Bus geladen, um Queue-Building im Software-Stack zu vermeiden.

POST /v1/order/new

Numerische Werte (Preis, Menge) müssen als String übergeben werden, um IEEE 754 Floating-Point Fehler zu eliminieren.

PAYLOAD SCHEMA JSON

{
  "symbol": "BTC-EUR",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": "0.5000",       // String for precision
  "price": "42500.00",
  "timeInForce": "GTC",       // Good-Till-Cancel
  "clientId": "algo-01-9923"  // Internal reconciliation ID
}

Supported Order Types

LIMIT	Standard Limit Order (Maker oder Taker).
MARKET	Sofortige Ausführung zum besten Preis. (Vorsicht bei geringer Liquidität).
ICEBERG	Verdeckte Liquidität. Nur die sichtbare Menge wird im öffentlichen Buch angezeigt.

Technical Execution Flags

Erweiterte Flags zur präzisen Steuerung der Execution Engine im Hochfrequenzbereich:

Flag	Time In Force	Description
GTC	Good-Till-Cancel	Order bleibt im Buch, bis sie ausgeführt oder manuell storniert wird.
IOC	Immediate-Or-Cancel	Sofortige Ausführung des verfügbaren Teils. Der Rest wird storniert.
FOK	Fill-Or-Kill	Order muss sofort vollständig ausgeführt werden, sonst erfolgt ein kompletter Storno.
POST_ONLY	Maker-Only	Stellt sicher, dass die Order nur als Maker ins Buch kommt. Vermeidet Taker-Fees.

Self-Trade Prevention: Verhindert das Matching gegen eigene Orders desselben Keys.
Hidden Volume: Orders mit Iceberg-Flag werden nur anteilig im öffentlichen Buch angezeigt.

Real-time Data Feeds

Für High-Frequency Strategien bieten wir binäre WebSocket-Streams mit Delta-Kompression. Dies minimiert die Bandbreitennutzung und reduziert die Paketgröße um bis zu 80%.

⚡

Endpoint Configuration

wss://stream.ez-invest.de/ws/market-data

Subscription Protocol

Senden Sie nach Verbindungsaufbau sofort eine Subscription-Message. Streams werden ohne Heartbeat nach 30 Sekunden getrennt.

CLIENT MESSAGE JSON

{
  "method": "SUBSCRIBE",
  "params": [
    "eth-eur@depth20",  // Top 20 Bids/Asks
    "btc-eur@ticker"    // Real-time Ticker
  ],
  "id": 1042
}

Market Data Depth (L2/L3)

Wir unterscheiden zwischen zwei Verarbeitungsstufen für Marktdaten, um unterschiedliche Analyse-Anforderungen zu bedienen.

Tier	Event Type	Latency Focus
Level 2	Aggregated Price Points	Normal (REST/WS)
Level 3	Individual Order Events	Ultra-Low (FPGA)

🔍

Level 3 Transparency

L3-Daten enthalten anonymisierte Order-IDs, die es ermöglichen, die Position einzelner institutioneller Teilnehmer im Orderbuch deterministisch zu tracken (Full Order Log).

Quantitative Risk Control

Unsere Infrastruktur erzwingt präventive Sicherheitsmechanismen auf Hardware-Ebene (FPGA Gatekeepers), um Marktintegrität und regulatorische Compliance ohne Latenzeinbußen sicherzustellen.

Pre-Trade Integrity Checks

🛡️

Ultra-Low Latency Guardrails

Risiko-Validierungen werden parallel zum Order-Routing in Hardware ausgeführt. Ein Verstoß führt zu einer Hardware-gesteuerten Order-Terminierung innerhalb von < 150 Nanosekunden.

Category	Validation Logic	SLA Policy
Fat-Finger Protection	Order Size & Price Deviation Check	Hardware Intercept
Risk Exposure	Aggregate Net Exposure Limits	Hard Stop
Compliance	MiFID II RTS 6 / SEC Rule 15c3-5	Deterministic Log

Stochastic Margin Modeling

Marginal-Anforderungen werden dynamisch basierend auf der aktuellen Volatilitätsmatrix berechnet. Wir nutzen stochastische Approximationen zur Echtzeit-Bewertung komplexer Derivate-Portfolios.