API Reference

The UTM API allows you to programmatically submit trading signals, manage accounts, and monitor orders.

Base URL

https://api.universaltrademanager.com/api/v1

Authentication

All API requests require authentication via API key. Include your key in the X-API-Key header:

curl -H "X-API-Key: your-api-key" https://api.example.com/api/v1/...

See API Keys for details on creating and managing keys.

Endpoints

Endpoint	Description
POST /api/v1/signals/ingest	Submit trading signals
GET /api/v1/accounts	List connected accounts
GET /api/v1/orders	List orders
GET /api/v1/positions	List positions

Standard Response Format

All API responses include a requestId for tracking:

Success:

{
  "signal": { "id": "uuid", "status": "executed" },
  "message": "Signal processed successfully",
  "requestId": "req_abc123"
}

Error:

{
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "details": [...],
  "requestId": "req_abc123"
}

Rate Limits

• 100 requests per minute per API key
• 1000 requests per hour per API key

Errors

See Error Codes for a complete list of error responses.