# Bolsa de Valores de Colombia (BVC) API
> Live Colombian equity data from the Bolsa de Valores de Colombia (BVC): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in Colombian peso COP), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the MSCI COLCAP benchmark index. Foreign depositary receipts are filtered out so you get only genuine Colombian companies such as Ecopetrol, Grupo Nutresa, ISA, Grupo Energia Bogota and Grupo Cibest.

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

## Pricing
- **Free** (Free) — 1,240 calls/Mo, 2 req/s
- **Basic** ($9/Mo) — 37,700 calls/Mo, 6 req/s
- **Pro** ($28/Mo) — 156,000 calls/Mo, 15 req/s
- **Business** ($59/Mo) — 651,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated BVC tickers (up to 20) Example: `ECOPETROL,NUTRESA,ISA`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/colombia-stock-api/v1/quote?symbols=ECOPETROL%2CNUTRESA%2CISA"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "BVC",
        "quotes": [
            {
                "low": 2810,
                "high": 2875,
                "last": 2875,
                "name": "Ecopetrol SA",
                "open": 2830,
                "pe_ttm": 13.4507,
                "sector": "Energy Minerals",
                "symbol": "ECOPETROL",
                "ticker": "BVC:ECOPETROL",
                "volume": 18993540,
                "currency": "COP",
                "change_abs": 40,
                "change_pct": 1.4109,
                "market_cap": 118210499023438
            },
            {
                "low": 305000,
                "high": 308000,
                "last": 305320,
                "name": "Grupo Nutresa S.A.",
                "open": 308000,
                "pe_ttm": 141.9446,
                "sector": "Consumer Non-Durables",
                "symbol": "NUTRESA",
                "ticker": "BVC:NUTRESA",
                "volume": 256,
                "currency": "COP",
                "change_abs": -2680,
                "change_pct": -0.8701,
                "market_cap": 138028185643311
            },
            {
                "low": 29500,
                "high": 32200,
                "last": 31500,
                "name": "Interconexion Electrica SA ESP",
                "open": 29780,
                "pe_ttm": 15.2755,
                "sector": "Utilities",
                "symbol": "ISA",
                "ticker
…(truncated, see openapi.json for full schema)
```

### Screener

#### `GET /v1/screener` — Rank local primary listings

**Parameters:**
- `sort` (query, optional, string) — Sort field: market_cap, change or volume Example: `market_cap`
- `order` (query, optional, string) — asc or desc Example: `desc`
- `limit` (query, optional, string) — Number of results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/colombia-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "BVC",
        "results": [
            {
                "low": 305000,
                "high": 308000,
                "last": 305320,
                "name": "Grupo Nutresa S.A.",
                "open": 308000,
                "pe_ttm": 141.9446,
                "sector": "Consumer Non-Durables",
                "symbol": "NUTRESA",
                "ticker": "BVC:NUTRESA",
                "volume": 256,
                "currency": "COP",
                "change_abs": -2680,
                "change_pct": -0.8701,
                "market_cap": 138028185643311
            },
            {
                "low": 2810,
                "high": 2875,
                "last": 2875,
                "name": "Ecopetrol SA",
                "open": 2830,
                "pe_ttm": 13.4507,
                "sector": "Energy Minerals",
                "symbol": "ECOPETROL",
                "ticker": "BVC:ECOPETROL",
                "volume": 18993540,
                "currency": "COP",
                "change_abs": 40,
                "change_pct": 1.4109,
                "market_cap": 118210499023438
            },
            {
                "low": 82100,
                "high": 85180,
                "last": 82500,
                "name": "Grupo Cibest S.A.",
                "open": 82600,
                "pe_ttm": 41.3631,
                "sector": "Finance",
              
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Colombian benchmark (MSCI COLCAP)

**Parameters:**
- `symbol` (query, optional, string) — Optional specific index symbol(s) Example: `ICAP`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/colombia-stock-api/v1/index?symbol=ICAP"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "BVC",
        "indices": [
            {
                "low": 2335.99,
                "high": 2395.66,
                "name": "MSCI COLCAP Index",
                "open": 2343.94,
                "index": "ICAP",
                "label": "MSCI COLCAP",
                "value": 2386.78,
                "change_abs": 91.67,
                "change_pct": 3.9941
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:02.703Z",
        "request_id": "b70c99fb-63d3-4e1f-9bf1-730bf560f4dc"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Market metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "market": "Bolsa de Valores de Colombia (BVC)",
        "source": "TradingView screener (colombia market), keyless",
        "country": "Colombia",
        "indices": [
            "ICAP"
        ],
        "currency": "COP",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=ECOPETROL,NUTRESA,ISA",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Colombian benchmark index (MSCI COLCAP = ICAP)",
            "/v1/quote": "live quote for one or more BVC stocks by ticker (symbols=ECOPETROL,NUTRESA,ISA)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:02.779Z",
        "request_id": "d88892ac-3e4c-47e3-ac4b-914597219919"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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