# Chartink — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical stock market data from Indian exchanges (NSE/BSE) to analyze fundamentals, technical indicators, and OHLCV metrics, plus run custom stock screeners to find investment opportunities. Search for specific stocks and browse all listed symbols to build data-driven trading strategies and investment research.

**Category:** Finance & Markets | **Website:** [chartink.com/](https://chartink.com/) | **Docs:** [parse.bot/marketplace/eecf2a5d-a2d4-4652-b392-a9adc48e5c63/chartink-com-api](https://parse.bot/marketplace/eecf2a5d-a2d4-4652-b392-a9adc48e5c63/chartink-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_listed_symbols

Retrieve all listed company symbols available on Chartink. Returns all NSE/BSE stocks with their code, name, latest close price, percentage change, and volume. Uses the screener engine internally with a permissive filter. The result set contains thousands of stocks — single-page response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/get_all_listed_symbols \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_fundamentals

Scrape fundamental analysis data for a given stock symbol from its dedicated Chartink page. Returns metrics including Industry, Market Cap, Net Profit, EPS, P/E ratio, Book Value, and other financial indicators. Returns input_not_found if the symbol does not exist on Chartink.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | NSE stock ticker symbol (e.g. RELIANCE, TCS, INFY). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/get_stock_fundamentals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_stock_technical_data

Retrieve technical chart data (OHLCV) for a symbol from Chartink's internal OAPI. Returns metadata including trade timestamps, available data points, and grouped OHLCV arrays keyed by symbol. Each OHLCV component (open, high, low, close, volume) is a separate object within the results array containing an array of values aligned with tradeTimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of data points (candles) to return. |
| `symbol` | string | Yes | NSE stock ticker symbol (e.g. RELIANCE, TCS, INFY). |
| `timeframe` | string | No | Chart timeframe. Accepted values: Daily, Weekly, Monthly. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/get_stock_technical_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","symbol":"<string>","timeframe":"<string>"}'
```

### run_stock_screener

Run a stock screener with a Chartink scan clause. Returns stocks matching the filter criteria. The scan clause uses Chartink's proprietary syntax. An invalid clause returns an upstream error from the screener engine.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `scan_clause` | string | Yes | Chartink scan clause filter condition using the site's proprietary syntax (e.g. '( {cash} ( latest close > 0 ) )', '( {cash} ( latest volume > 10000000 ) )'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/run_stock_screener \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scan_clause":"<string>"}'
```

### search_stock_symbol

Search for a company by name or partial symbol. Performs a case-insensitive substring match against all listed stocks' NSE codes and company names. Fetches the full stock list internally, so latency is comparable to get_all_listed_symbols.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search string to match against stock symbol or company name (e.g. RELIANCE, Infosys, TCS). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chartink-com-api-eecf2a5d/search_stock_symbol \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
