# Foxhunt API Quick Reference **Version**: 1.0 | **Date**: 2025-10-16 | **Gateway**: `localhost:50051` --- ## Quick Start ### Authentication ```bash tli auth login --username --password tli auth verify-mfa --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
```bash
# Submit order
tli trade submit --symbol ES.FUT --side BUY --quantity 10 --type MARKET

# Cancel order
tli trade cancel --order-id 

# Get positions
tli trade positions [--symbol ]

# Portfolio summary
tli trade portfolio
```

### ML Trading
```bash
# 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 ]
```

### Trading Agent
```bash
# 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 
```

### ML Training
```bash
# Train model
tli ml train --model  --epochs  --gpu

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

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

### Backtesting
```bash
# Start backtest
tli backtest start --strategy  --symbols ES.FUT,NQ.FUT \
  --start 2024-01-01 --end 2024-03-31 --capital 100000

# Get results
tli backtest results --id  --with-trades
```

### Risk Management
```bash
# 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
```bash
# 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.