Help | centh research

Help & Usage Guidelines

How to Use the Research Tool

Video Walkthrough

Each query you submit should be self-contained. The system has limited chat history memory, so please avoid referencing older prompts or results.
System can take obscure queries to certain extent if recent previous queries give supporting context.

When the system generates code, only functionalities provided by the following libraries are supported:

pandas
numpy
scipy
statsmodels
scikit-learn

NSE DATA

NSE currently covers hourly data for equities and options. Only OHLCV time series data are available. For options, open interest data are also available. Moreover, prominent indices and their components are also available.

NASDAQ DATA

NASDAQ currently covers end of day data for equities. Only OHLCV time series data are available. No indice decomposition data are available as of now.

SMART WATCHLIST

Smart Watchlist currently supports only time series based watchlist conditions. Overly complex queries are not supported. You can add a rule to watchlist only when the Test output successfully detects tickers.

Important Disclaimer

The automated financial researcher is an experimental tool. Outputs generated by the system are intended for informational and research purposes only.

All analysis, insights, recommendations, and backtesting results must be independently verified before being relied upon.

⚠️ Please Note:
Exercise caution and conduct your own due diligence before making any investment or trading decisions. Centh Research does not assume responsibility for actions taken based on AI-generated outputs.

API & Data section

Base URL: https://centhresearch.com

Note: API-key based endpoints use the header X-API-KEY.

1) Company Names API

GET /api/v1/company_names/: returns supported tickers for fundamental data, grouped by country code.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

# 1) Company names by country
resp = requests.get(
    f"{BASE_URL}/api/v1/company_names/",
    headers=HEADERS,
    timeout=30,
)
print(resp.status_code)
print(resp.json())

2) Supported Option Underlyings API

GET /api/v1/companies_supported_option_valuation/
Returns underlyings (tickers) for which pricing and simulations are available.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

resp = requests.get(
    f"{BASE_URL}/api/v1/companies_supported_option_valuation/",
    headers=HEADERS,
    timeout=30,
)
print(resp.status_code)
print(resp.json())

3) Fundamental Data API

GET /api/v1/fundamental_data/?ticker=RELIANCE&country=IND
Required params: ticker, country
Returns latest fundamental data.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

resp = requests.get(
    f"{BASE_URL}/api/v1/fundamental_data/",
    headers=HEADERS,
    params={"ticker": "RELIANCE", "country": "IND"},
    timeout=30,
)
print(resp.status_code)
payload = resp.json()
print(payload.keys())
print("item_count:", len(payload.get("items", [])))

4) File Download API

GET /api/v1/file_download/?ticker=RELIANCE&country=IND&filing_type=Q
Required params: ticker, country, filing_type (Q = quarterly, A = annually).
Returns binary file as attachment when available.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

resp = requests.get(
    f"{BASE_URL}/api/v1/file_download/",
    headers=HEADERS,
    params={"ticker": "RELIANCE", "country": "IND", "filing_type": "Q"},
    timeout=60,
)
print(resp.status_code)
if resp.status_code == 200:
    with open("downloaded_report.pdf", "wb") as f:
        f.write(resp.content)

5) Option Valuation Simulation API

GET /api/v1/option_valuation_simulation/?underlying=NIFTY
Required param: underlying
Returns only future expiries (expiry > today), grouped by expiry in data_by_expiry.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

resp = requests.get(
    f"{BASE_URL}/api/v1/option_valuation_simulation/",
    headers=HEADERS,
    params={"underlying": "NIFTY"},
    timeout=30,
)
print(resp.status_code)
payload = resp.json()
print("expiries:", payload.get("expiries", []))
print("expiry keys:", list(payload.get("data_by_expiry", {}).keys()))

6) Generic Search API

GET /api/v1/search/?query_text=nifty outlook
Required param: query_text
Get generic search service to assist your research / AI agent.

import requests

BASE_URL = "https://centhresearch.com"
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-KEY": API_KEY}

resp = requests.get(
    f"{BASE_URL}/api/v1/search/",
    headers=HEADERS,
    params={"query_text": "nifty outlook"},
    timeout=30,
)
print(resp.status_code)
print(resp.json())