# Bursa Malaysia (KLSE) API
> Live data for Bursa Malaysia (the KLSE / Malaysian stock 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 ringgit, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and a search across the market by company name or ticker (optionally by sector).

## 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/klse-api/..."
```

## Pricing
- **Free** (Free) — 14,000 calls/Mo, 2 req/s
- **Basic** ($21/Mo) — 290,000 calls/Mo, 10 req/s
- **Pro** ($55/Mo) — 1,580,000 calls/Mo, 20 req/s
- **Scale** ($128/Mo) — 8,050,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `codes` (query, required, string) — MYX ticker(s), comma-separated up to 20 Example: `MAYBANK,TENAGA`

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

**Response:**
```json
{
    "data": {
        "note": "The live quote for one or more Malaysian (Bursa Malaysia) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in ringgit), with the company name. Pass codes (the MYX ticker, comma-separate up to 20, e.g. MAYBANK,TENAGA).",
        "count": 2,
        "quotes": [
            {
                "low": 10.76,
                "high": 10.94,
                "open": 10.78,
                "price": 10.9,
                "change": 0.17999999999999972,
                "sector": "Finance",
                "ticker": "MAYBANK",
                "volume": 1208400,
                "company": "Malayan Banking Bhd.",
                "currency": "MYR",
                "pe_ratio": 12.66,
                "market_cap": 129661910261,
                "change_percent": 1.68
            },
            {
                "low": 14.46,
                "high": 14.7,
                "open": 14.5,
                "price": 14.5,
                "change": 0.08000000000000007,
                "sector": "Utilities",
                "ticker": "TENAGA",
                "volume": 1400000,
                "company": "Tenaga Nasional Bhd",
                "currency": "MYR",
                "pe_ratio": 17.57,
                "market_cap": 84056229380,
                "change_percent": 0.55
            }
        ],
        "source": "Bursa Malaysia / KLSE (TradingView)"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:43.551Z",
        "request_id": 
…(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: `gainers`
- `limit` (query, optional, string) — Results 1-100 Example: `20`

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

**Response:**
```json
{
    "data": {
        "by": "gainers",
        "note": "A ranked screener of the Malaysian (Bursa Malaysia) 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": "Bursa Malaysia / KLSE (TradingView)",
        "results": [
            {
                "price": 0.085,
                "change": 0.015,
                "sector": "Finance",
                "ticker": "PARKWD",
                "volume": 600,
                "company": "Parkwood Holdings Bhd.",
                "currency": "MYR",
                "market_cap": 50054671,
                "change_percent": 21.43
            },
            {
                "price": 0.15,
                "change": 0.024999999999999994,
                "sector": "Industrial Services",
                "ticker": "EIB",
                "volume": 1000,
                "company": "Ecoscience International Bhd.",
                "currency": "MYR",
                "market_cap": 56100002,
                "change_percent": 20
            },
            {
                "price": 0.295,
                "change": 0.034999999999999976,
                "sector": "Non-Energy Minerals",
                "ticker": "LIONPSIM",
                "volume": 2000,
                "company": "Lion Posim Bhd.",
                "currency": "MYR",
                "market_cap": 672
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search` — Search the market by name or ticker

**Parameters:**
- `q` (query, required, string) — Company name or ticker fragment Example: `bank`
- `sector` (query, optional, string) — Narrow to a sector Example: `Finance`
- `limit` (query, optional, string) — Results 1-50 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/klse-api/v1/search?q=bank&sector=Finance&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "Search the Malaysian (Bursa Malaysia) market by company name or ticker — matching stocks ranked by market cap. Pass q (the name or ticker fragment, e.g. bank), optionally sector (e.g. Finance, Utilities) and limit (1-50, default 20).",
        "count": 8,
        "query": "bank",
        "sector": "Finance",
        "source": "Bursa Malaysia / KLSE (TradingView)",
        "results": [
            {
                "price": 10.9,
                "change": 0.17999999999999972,
                "sector": "Finance",
                "ticker": "MAYBANK",
                "volume": 1208400,
                "company": "Malayan Banking Bhd.",
                "currency": "MYR",
                "market_cap": 129661910261,
                "change_percent": 1.68
            },
            {
                "price": 4.88,
                "change": 0.04999999999999982,
                "sector": "Finance",
                "ticker": "PBBANK",
                "volume": 2250200,
                "company": "Public Bank Bhd",
                "currency": "MYR",
                "market_cap": 93753638011,
                "change_percent": 1.04
            },
            {
                "price": 21.54,
                "change": 0.1999999999999993,
                "sector": "Finance",
                "ticker": "HLBANK",
                "volume": 17500,
                "company": "Hong Leong Bank Bhd",
                "currency": "MYR",
                "market_cap": 4
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "maybank": 10.9
        },
        "source": "TradingView public screener (scanner.tradingview.com/malaysia/scan), keyless",
        "screens": [
            "gainers",
            "losers",
            "active",
            "marketcap"
        ],
        "service": "klse-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/quote": "Live quote for one or more stocks (codes).",
            "GET /v1/search": "Search by company name or ticker (q, sector, limit).",
            "GET /v1/screener": "Ranked market screener (by, limit)."
        },
        "description": "Live data for Bursa Malaysia (the KLSE / Malaysian stock 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 ringgit, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and a search across the market by company name or ticker (optionally by sector). The Malaysia-equities / screener / search layer for trading dashboards and research. Distinct from other exchange readers — the Bursa Malaysia (MYX) market with a built-in screener and name search. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:44.223Z",
        "request_id": "bfc5dbe6-f969-4b87-911e-ccc409945296"
    },
    "status": "ok",
    "message": "Meta",
    "
…(truncated, see openapi.json for full schema)
```


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