# Santiago Stock Exchange (Chile) API
> Live data for the Santiago Stock Exchange (Bolsa de Santiago, the Chilean 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 Chilean pesos, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; primary Chilean listings only), 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/chile-stock-api/..."
```

## Pricing
- **Free** (Free) — 13,900 calls/Mo, 2 req/s
- **Basic** ($22/Mo) — 308,000 calls/Mo, 10 req/s
- **Pro** ($62/Mo) — 1,640,000 calls/Mo, 20 req/s
- **Scale** ($122/Mo) — 8,400,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `codes` (query, required, string) — BCS ticker(s), comma-separated up to 20 Example: `CHILE,SQM_A`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/chile-stock-api/v1/quote?codes=CHILE%2CSQM_A"
```

**Response:**
```json
{
    "data": {
        "note": "The live quote for one or more Chilean (Santiago) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in Chilean pesos), with the company name. Pass codes (the BCS ticker, comma-separate up to 20, e.g. CHILE,SQM_A).",
        "count": 2,
        "quotes": [
            {
                "low": 178.52,
                "high": 182.6,
                "open": 179.9,
                "price": 182,
                "change": 3.75,
                "sector": "Finance",
                "ticker": "CHILE",
                "volume": 110873640,
                "company": "Banco de Chile",
                "currency": "CLP",
                "pe_ratio": 16.24,
                "market_cap": 18385108218750,
                "change_percent": 2.1
            },
            {
                "low": 64550,
                "high": 65210,
                "open": 64550,
                "price": 64936,
                "change": 837,
                "sector": "Process Industries",
                "ticker": "SQM_A",
                "volume": 742,
                "company": "Sociedad Quimica y Minera de Chile SA Pfd Series A",
                "currency": "CLP",
                "pe_ratio": 24.74,
                "market_cap": 20056916260986,
                "change_percent": 1.31
            }
        ],
        "source": "Santiago Stock Exchange / Bolsa de Santiago (TradingView)"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:25.053Z",

…(truncated, see openapi.json for full schema)
```

### Screener

#### `GET /v1/screener` — Ranked market screener (primary Chilean listings)

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

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

**Response:**
```json
{
    "data": {
        "by": "marketcap",
        "note": "A ranked screener of the Chilean (Santiago) market — the top stocks by your chosen ranking, limited to primary Chilean listings. Pass by (gainers, losers, active, or marketcap; default marketcap) and limit (1-100, default 20).",
        "count": 20,
        "source": "Santiago Stock Exchange / Bolsa de Santiago (TradingView)",
        "results": [
            {
                "price": 64936,
                "change": 837,
                "sector": "Process Industries",
                "ticker": "SQM_A",
                "volume": 742,
                "company": "Sociedad Quimica y Minera de Chile SA Pfd Series A",
                "currency": "CLP",
                "market_cap": 20056916260986,
                "change_percent": 1.31
            },
            {
                "price": 182,
                "change": 3.75,
                "sector": "Finance",
                "ticker": "CHILE",
                "volume": 110873640,
                "company": "Banco de Chile",
                "currency": "CLP",
                "market_cap": 18385108218750,
                "change_percent": 2.1
            },
            {
                "price": 5950,
                "change": -20,
                "sector": "Retail Trade",
                "ticker": "FALABELLA",
                "volume": 2146939,
                "company": "Falabella S.A.",
                "currency": "CLP",
                "market_cap": 14927626123047,
…(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: `banco`
- `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/chile-stock-api/v1/search?q=banco&sector=Finance&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "Search the Chilean (Santiago) market by company name or ticker — matching primary Chilean listings ranked by market cap. Pass q (the name or ticker fragment, e.g. banco), optionally sector (e.g. Finance, Retail Trade) and limit (1-50, default 20).",
        "count": 4,
        "query": "banco",
        "sector": "Finance",
        "source": "Santiago Stock Exchange / Bolsa de Santiago (TradingView)",
        "results": [
            {
                "price": 182,
                "change": 3.75,
                "sector": "Finance",
                "ticker": "CHILE",
                "volume": 110873640,
                "company": "Banco de Chile",
                "currency": "CLP",
                "market_cap": 18385108218750,
                "change_percent": 2.1
            },
            {
                "price": 73.6,
                "change": 1.1599999999999966,
                "sector": "Finance",
                "ticker": "BSANTANDER",
                "volume": 163639205,
                "company": "Banco Santander-Chile",
                "currency": "CLP",
                "market_cap": 13869634512454,
                "change_percent": 1.6
            },
            {
                "price": 61299,
                "change": 809,
                "sector": "Finance",
                "ticker": "BCI",
                "volume": 50449,
                "company": "Banco de Credito e Inversiones",
                "currency": "CLP",
         
…(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/chile-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "banco_de_chile": 182
        },
        "source": "TradingView public screener (scanner.tradingview.com/chile/scan), keyless",
        "screens": [
            "gainers",
            "losers",
            "active",
            "marketcap"
        ],
        "service": "chile-stock-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 the Santiago Stock Exchange (Bolsa de Santiago, the Chilean 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 Chilean pesos, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; primary Chilean listings only), and a search across the market by company name or ticker (optionally by sector). The Chile-equities / screener / search layer for trading dashboards and research. Distinct from other exchange readers — the Santiago Stock Exchange market with a built-in screener and name search. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:25.691Z",
        "request_id": "1c6f4f92-e386-4ee4-a276-cc028
…(truncated, see openapi.json for full schema)
```


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