# Dhaka Stock Exchange (DSE) API
> Live data for the Dhaka Stock Exchange (DSE, the Bangladesh market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in taka, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the DSE indices (DSE Broad Index DSEX and DSEX Shariah Index DSES).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/dse-api/..."
```

## Pricing
- **Free** (Free) — 8,300 calls/Mo, 2 req/s
- **Basic** ($16/Mo) — 201,000 calls/Mo, 10 req/s
- **Pro** ($55/Mo) — 1,150,000 calls/Mo, 20 req/s
- **Scale** ($89/Mo) — 6,240,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

#### `GET /v1/quote` — Live quote for one or more DSE stocks

**Parameters:**
- `codes` (query, required, string) — DSE ticker(s), comma-separated up to 20 Example: `GP,SQURPHARMA`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dse-api/v1/quote?codes=GP%2CSQURPHARMA"
```

**Response:**
```json
{
    "data": {
        "note": "The live quote for one or more Bangladeshi (DSE) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in taka), with the company name. Pass codes (the DSE ticker, comma-separate up to 20, e.g. GP,SQURPHARMA).",
        "count": 2,
        "quotes": [
            {
                "low": 247.5,
                "high": 251,
                "open": 251,
                "price": 247.8,
                "change": -2.0999999999999943,
                "sector": "Communications",
                "ticker": "GP",
                "volume": 73005,
                "company": "Grameenphone Ltd.",
                "currency": "BDT",
                "pe_ratio": 11.21,
                "market_cap": 334604356220,
                "change_percent": -0.84
            },
            {
                "low": 215.4,
                "high": 216.3,
                "open": 216,
                "price": 215.7,
                "change": -0.30000000000001137,
                "sector": "Health Technology",
                "ticker": "SQURPHARMA",
                "volume": 537599,
                "company": "Square Pharmaceuticals PLC",
                "currency": "BDT",
                "pe_ratio": 7.39,
                "market_cap": 191207475572,
                "change_percent": -0.14
            }
        ],
        "source": "Dhaka Stock Exchange / DSE (TradingView)"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:33.685Z",
        "reque
…(truncated, see openapi.json for full schema)
```

### Screener

#### `GET /v1/screener` — Ranked market screener

**Parameters:**
- `by` (query, optional, string) — Ranking: gainers, losers, active, marketcap Example: `active`
- `limit` (query, optional, string) — Results 1-100 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dse-api/v1/screener?by=active&limit=20"
```

**Response:**
```json
{
    "data": {
        "by": "active",
        "note": "A ranked screener of the Bangladeshi (DSE) market — the top stocks by your chosen ranking. Pass by (gainers, losers, active, or marketcap; default marketcap) and limit (1-100, default 20). Only real stocks above a market-cap floor are ranked.",
        "count": 20,
        "source": "Dhaka Stock Exchange / DSE (TradingView)",
        "results": [
            {
                "price": 23.7,
                "change": 2.099999999999998,
                "sector": "Finance",
                "ticker": "IPDC",
                "volume": 16901481,
                "company": "IPDC Finance PLC",
                "currency": "BDT",
                "market_cap": 10181161009,
                "change_percent": 9.72
            },
            {
                "price": 16.3,
                "change": -0.5,
                "sector": "Finance",
                "ticker": "NCCBANK",
                "volume": 14166069,
                "company": "National Credit and Commerce Bank PLC",
                "currency": "BDT",
                "market_cap": 18823890562,
                "change_percent": -2.98
            },
            {
                "price": 17.2,
                "change": 1.5,
                "sector": "Consumer Non-Durables",
                "ticker": "FEKDIL",
                "volume": 9087008,
                "company": "Far East Knitting & Dyeing Industries PLC.",
                "currency": "BDT",
                "marke
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Live value of a DSE index

**Parameters:**
- `name` (query, optional, string) — DSEX or DSES Example: `DSEX`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dse-api/v1/index?name=DSEX"
```

**Response:**
```json
{
    "data": {
        "low": 5513.42047,
        "high": 5554.31106,
        "name": "DSE Broad Index",
        "note": "The live value of a Dhaka Stock Exchange index — current level, change, and the day's open/high/low. Pass name (DSEX for the DSE Broad Index, or DSES for the DSEX Shariah Index; default DSEX).",
        "open": 5516.82363,
        "index": "DSEX",
        "value": 5520.39656,
        "change": 3.5729300000002695,
        "source": "Dhaka Stock Exchange / DSE (TradingView)",
        "change_percent": 0.06
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:34.057Z",
        "request_id": "02342f62-e0a9-486a-a99c-aa5c243deb44"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata & endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dse-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "dsex": 5520.39656
        },
        "source": "TradingView public screener (scanner.tradingview.com/bangladesh/scan), keyless",
        "indexes": [
            "DSEX",
            "DSES"
        ],
        "screens": [
            "gainers",
            "losers",
            "active",
            "marketcap"
        ],
        "service": "dse-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/index": "Live value of a DSE index (name).",
            "GET /v1/quote": "Live quote for one or more stocks (codes).",
            "GET /v1/screener": "Ranked market screener (by, limit)."
        },
        "description": "Live data for the Dhaka Stock Exchange (DSE, the Bangladesh market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in taka, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the DSE indices (DSE Broad Index DSEX and DSEX Shariah Index DSES). The Bangladesh-equities / DSE-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the DSE market with a built-in screener and a Shariah index. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:34.146Z",
        "request_id": "a7d78204-467c-4cef-9b87-b4abe006a366"
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/dse-api
OpenAPI spec: https://www.oanor.com/api/dse-api/openapi.json
