API Documentation

The Candlery API provides real-time access to our deterministic execution signals. All endpoints are RESTful and return standard JSON.

Authentication

Authenticate via Bearer token in the Authorization header.

curl -X GET https://api.candlery.in/v1/signals \
  -H "Authorization: Bearer sk_live_..."

Signal Object

When a signal passes the risk firewall, it is structured as follows:

{
  "id": "sig_01H9X...",
  "ticker": "RELIANCE",
  "source": "10-Q",
  "intent": "CAPEX_REDUCTION",
  "confidence": 0.98,
  "timestamp": "2026-06-05T14:30:00Z",
  "metadata": {
    "historical_analog_found": true
  }
}

To request production API access, please contact contact@candlery.in.