foxhunt/docs/archive/api/API_QUICK_REFERENCE.md

Foxhunt API Quick Reference

Version: 1.0 | Date: 2025-10-16 | Gateway: localhost:50051

---

Quick Start

Authentication

tli auth login --username <user> --password <pass>
tli auth verify-mfa --code <code>
# Token stored at ~/.config/foxhunt-tli/tokens/

Service Endpoints

Service	Port	Health
API Gateway	50051	8080
Trading	50052	8081
Backtesting	50053	8082
ML Training	50054	8095
Trading Agent	50055	-

---

Essential Commands

Trading

# Submit order
tli trade submit --symbol ES.FUT --side BUY --quantity 10 --type MARKET

# Cancel order
tli trade cancel --order-id <id>

# Get positions
tli trade positions [--symbol <symbol>]

# Portfolio summary
tli trade portfolio

ML Trading

# Submit ML order (ensemble)
tli trade ml submit --symbol ES.FUT

# Submit ML order (specific model)
tli trade ml submit --symbol ES.FUT --model DQN

# Get predictions
tli trade ml predictions --symbol ES.FUT --limit 50

# Model performance
tli trade ml performance [--model <model>]

Trading Agent

# Universe selection
tli agent universe select --max-instruments 50

# Asset selection
tli agent assets select --max-assets 20

# Portfolio allocation
tli agent allocate --strategy ML --capital 1000000

# Generate orders
tli agent orders generate
tli agent orders submit --batch-id <id>

ML Training

# Train model
tli ml train --model <DQN|PPO|MAMBA2|TFT> --epochs <n> --gpu

# Hyperparameter tuning
tli tune start --model DQN --trials 50 --watch

# Batch tuning
tli tune batch --models DQN,PPO,MAMBA2,TFT --trials 30

Backtesting

# Start backtest
tli backtest start --strategy <name> --symbols ES.FUT,NQ.FUT \
  --start 2024-01-01 --end 2024-03-31 --capital 100000

# Get results
tli backtest results --id <backtest_id> --with-trades

Risk Management

# Get VaR
tli risk var --confidence 0.95 --lookback 30

# Validate order
tli risk validate --symbol ES.FUT --side BUY --quantity 10 --price 4500

# Emergency stop (ADMIN only)
tli risk emergency-stop --type ALL --reason "Market volatility"

Monitoring

# System status
tli monitor status

# Performance metrics
tli monitor latency
tli monitor throughput

# Active alerts
tli monitor alerts --severity CRITICAL

---

Service Method Count

Service	Methods
Trading Service	15
Trading Agent Service	18
ML Training Service	12
Backtesting Service	6
Risk Management Service	6
Monitoring Service	10
Configuration Service	4
Total	71

---

Performance Benchmarks

Operation	P99 Latency	Status
Authentication	4.4μs	✅ <10μs
Order Matching	1-6μs	✅ <50μs
Order Submission	15.96ms	✅ <100ms
API Gateway Proxy	21-488μs	✅ <1ms
DBN Data Loading	0.70ms	✅ <10ms (14x faster)
ML Inference (DQN)	~200μs	✅ <1ms
ML Inference (MAMBA-2)	~500μs	✅ <1ms
Universe Selection	<1s	✅ Target met
Asset Selection	<2s	✅ Target met
Portfolio Allocation	<500ms	✅ Target met

---

Rate Limits

Endpoint Type	Req/Sec	Burst
Trading Operations	100	200
Market Data Streams	10 streams	20 streams
Backtesting	5	10
ML Training	2	5
Configuration	10	20

---

Error Codes

gRPC Code	HTTP	Description
OK (0)	200	Success
INVALID_ARGUMENT (3)	400	Invalid params
UNAUTHENTICATED (16)	401	Invalid JWT
PERMISSION_DENIED (7)	403	Insufficient permissions
NOT_FOUND (5)	404	Resource not found
RESOURCE_EXHAUSTED (8)	429	Rate limit exceeded
INTERNAL (13)	500	Internal error
UNAVAILABLE (14)	503	Service unavailable

---

ML Models

Model	Training Time	Inference	GPU Memory	Status
DQN	~15s (50 epochs)	~200μs	6MB	✅ Production
PPO	~7s (10 epochs)	~324μs	145MB	✅ Production
MAMBA-2	~1.86min (200 epochs)	~500μs	164MB	✅ Production
TFT-INT8	~5-7 days	~3.2ms	738MB	✅ Production
TLOB	N/A	<100μs	<1MB	✅ Inference-only

---

Allocation Strategies

1. Equal Weight: 1/N allocation
2. Risk Parity: Equal risk contribution
3. Mean-Variance: Markowitz optimization
4. ML-Optimized: ML model-driven
5. Kelly Criterion: Optimal bet sizing

---

Common Data Types

OrderSide

• ORDER_SIDE_BUY (1)
• ORDER_SIDE_SELL (2)

OrderType

• ORDER_TYPE_MARKET (1)
• ORDER_TYPE_LIMIT (2)
• ORDER_TYPE_STOP (3)
• ORDER_TYPE_STOP_LIMIT (4)

OrderStatus

• ORDER_STATUS_PENDING (1)
• ORDER_STATUS_SUBMITTED (2)
• ORDER_STATUS_PARTIALLY_FILLED (3)
• ORDER_STATUS_FILLED (4)
• ORDER_STATUS_CANCELLED (5)
• ORDER_STATUS_REJECTED (6)

RiskLevel

• RISK_LEVEL_LOW (1)
• RISK_LEVEL_MEDIUM (2)
• RISK_LEVEL_HIGH (3)
• RISK_LEVEL_CRITICAL (4)

---

Resources

• Full API Docs: API_DOCUMENTATION.md
• Method Count Audit: API_METHOD_COUNT_VERIFICATION.md
• Wave Summary: WAVE_14_AGENT_24_API_DOCS_SUMMARY.md
• System Architecture: CLAUDE.md

---

Need Help? See API_DOCUMENTATION.md for complete reference with examples.