API Documentation

Quick Start

All API requests require an X-API-Key header.

Base URL: https://api.treumalgotech.in

Swagger UI

Interactive API explorer with Try It

ReDoc

Clean reference documentation

Endpoint Reference

Signals

GET

/v1/signals/latest

Get latest earnings signals with pagination and filters

GET

/v1/signals/today

Get all signals from today's trading session

GET

/v1/signals/high-score

Get high-confidence signals (score ≥ 70)

GET

/v1/signals/{symbol}

Get signals for a specific company symbol

Earnings V2

GET

/v2/earnings/{symbol}/history

Multi-quarter earnings history with derived metrics

GET

/v2/earnings/screener

Screen companies by financial metrics with filters

GET

/v2/earnings/screener/export

Export screener results as CSV

GET

/v2/earnings/{symbol}/summary

AI-generated earnings intelligence summary

Search & Data

GET

/v1/search

Search signals by company name or symbol

GET

/v1/earnings/{symbol}

Get QoQ earnings data for a specific symbol

GET

/v1/earnings/qoq

Get QoQ earnings changes across all companies

Webhooks

POST

/v1/webhooks

GET

/v1/webhooks

List your active webhook subscriptions

DELETE

/v1/webhooks/{id}

Delete a webhook subscription

Python Example

python

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.treumalgotech.in"

# Get latest signals
resp = requests.get(
    f"{BASE_URL}/v1/signals/latest",
    headers={"X-API-Key": API_KEY},
    params={"limit": 10, "min_score": 50}
)
signals = resp.json()
print(f"Found {signals['data']['total']} signals")

# Get company earnings history
resp = requests.get(
    f"{BASE_URL}/v2/earnings/RELIANCE/history",
    headers={"X-API-Key": API_KEY}
)
history = resp.json()
for q in history["data"]["quarters"]:
    print(f"{q['quarter']}: Revenue ₹{q['revenue_cr']} Cr")

Rate Limits

Tier	Rate Limit	Data Delay
Free	10 req/min	30 min
Basic	60 req/min	15 min
Pro	300 req/min	Real-time
Enterprise	1000 req/min	Real-time