DOCUMENTATION

API Reference

Integrate ElCafé Capital data into your own applications.

Authentication

All API requests (except health check) require an API key to be sent in the Authorization: Bearer YOUR_API_KEY header. You can generate your key in the API Portal.

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.elcafecapital.com/v1/...

Simulation Endpoints

POST /v1/simulate

Run a standard Monte Carlo simulation using Hermes or Kronos engines.

Request Body (SimulateRequest):

{
  "ticker": "string",
  "n_sim": "integer [1000, 5000000]",
  "sim_days": "integer [1, 252]",
  "min_window": "integer [2, 252]",
  "engine": "string ^(auto|hermes|kronos)$",
  "seed": "integer (optional)"
}

POST /v1/simulate/afrodita

Run a specialized Afrodita stochastic volatility simulation.

Request Body (AfroditaRequest):

{
  "ticker": "string",
  "n_paths": "integer [100, 100000]",
  "window": "integer [1, 60]",
  "seed": "integer (optional)",
  "use_hermes_closes": "boolean (optional)",
  "n_hermes": "integer (optional)"
}

System Endpoints

GET /v1/health

Check API health status (No authentication required).

GET /v1/calibrate

Calibrate system models.

Rate Limits

The standard institutional tier is limited to 60 requests per hour. Contact support for enterprise limits.