# Lima Stock Exchange (BVL) API
> Live Peruvian equity data from the Lima Stock Exchange (BVL): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in PEN/USD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, a name search to find BVL stocks by company name, and the Peru general index (MSCI NUAM Peru General). Foreign depositary receipts are filtered out so you get only genuine Peruvian companies such as Banco de Credito, BBVA Peru and Buenaventura.

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

## Pricing
- **Free** (Free) — 1,600 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 46,000 calls/Mo, 5 req/s
- **Pro** ($37/Mo) — 185,000 calls/Mo, 15 req/s
- **Business** ($81/Mo) — 760,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated BVL tickers (up to 20) Example: `CREDITC1,BBVAC1,BACKUAC1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/peru-stock-api/v1/quote?symbols=CREDITC1%2CBBVAC1%2CBACKUAC1"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "BVL",
        "quotes": [
            {
                "low": 6.3,
                "high": 6.45,
                "last": 6.36,
                "name": "Banco de Credito del Peru SA",
                "open": 6.45,
                "pe_ttm": 12.0386,
                "sector": "Finance",
                "symbol": "CREDITC1",
                "ticker": "BVL:CREDITC1",
                "volume": 68955,
                "currency": "PEN",
                "change_abs": 0.06,
                "change_pct": 0.9524,
                "market_cap": 82535337959
            },
            {
                "low": 1.94,
                "high": 1.95,
                "last": 1.95,
                "name": "Banco BBVA Peru SA",
                "open": 1.95,
                "pe_ttm": 8.2278,
                "sector": "Finance",
                "symbol": "BBVAC1",
                "ticker": "BVL:BBVAC1",
                "volume": 480440,
                "currency": "PEN",
                "change_abs": 0,
                "change_pct": 0,
                "market_cap": 20681319646
            },
            {
                "low": 220,
                "high": 220,
                "last": 220,
                "name": "Union De Cervecerias Peruanas Backus & Johnston SAA Class A",
                "open": 220,
                "pe_ttm": 95.1351,
                "sector": "Consumer Non-Durables",
                "symbol": "BACKUAC1",
                "ticke
…(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/peru-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "BVL",
        "results": [
            {
                "low": 6.3,
                "high": 6.45,
                "last": 6.36,
                "name": "Banco de Credito del Peru SA",
                "open": 6.45,
                "pe_ttm": 12.0386,
                "sector": "Finance",
                "symbol": "CREDITC1",
                "ticker": "BVL:CREDITC1",
                "volume": 68955,
                "currency": "PEN",
                "change_abs": 0.06,
                "change_pct": 0.9524,
                "market_cap": 82535337959
            },
            {
                "low": 55.6,
                "high": 60,
                "last": 59,
                "name": "Sociedad Minera Cerro Verde SAA",
                "open": 59,
                "pe_ttm": 13.8498,
                "sector": "Non-Energy Minerals",
                "symbol": "CVERDEC1",
                "ticker": "BVL:CVERDEC1",
                "volume": 779,
                "currency": "USD",
                "change_abs": 0,
                "change_pct": 0,
                "market_cap": 70334970007.50528
            },
            {
                "low": 220,
                "high": 220,
                "last": 220,
                "name": "Union De Cervecerias Peruanas Backus & Johnston SAA Class A",
                "open": 220,
                "pe_ttm": 95.1351,
                "sector": "
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search` — Find BVL stocks by company name

**Parameters:**
- `q` (query, required, string) — Company name fragment Example: `banco`
- `limit` (query, optional, string) — Number of results (1-50) Example: `20`

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

**Response:**
```json
{
    "data": {
        "count": 3,
        "query": "banco",
        "market": "BVL",
        "results": [
            {
                "low": 1.9,
                "high": 1.9,
                "last": 1.9,
                "name": "Banco Internacional del Peru SAA Interbank",
                "open": 1.9,
                "pe_ttm": 8.0508,
                "sector": "Finance",
                "symbol": "INTERBC1",
                "ticker": "BVL:INTERBC1",
                "volume": 1262,
                "currency": "PEN",
                "change_abs": 0,
                "change_pct": 0,
                "market_cap": 12795045152
            },
            {
                "low": 1.94,
                "high": 1.95,
                "last": 1.95,
                "name": "Banco BBVA Peru SA",
                "open": 1.95,
                "pe_ttm": 8.2278,
                "sector": "Finance",
                "symbol": "BBVAC1",
                "ticker": "BVL:BBVAC1",
                "volume": 480440,
                "currency": "PEN",
                "change_abs": 0,
                "change_pct": 0,
                "market_cap": 20681319646
            },
            {
                "low": 6.3,
                "high": 6.45,
                "last": 6.36,
                "name": "Banco de Credito del Peru SA",
                "open": 6.45,
                "pe_ttm": 12.0386,
                "sector": "Finance",
                "symbol": "CREDITC1",
                "ticker": "BVL:CREDI
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Peru general index (MSCI NUAM Peru General)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "BVL",
        "indices": [
            {
                "low": 55088.83,
                "high": 56491.6,
                "name": "MSCI NUAM Peru General",
                "open": 55092.36,
                "index": "MXNUAMPEGEN",
                "value": 56321.11,
                "change_abs": 2278.8,
                "change_pct": 4.2167
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:18.175Z",
        "request_id": "937238ed-2cfa-46b5-b7ec-83110869d499"
    },
    "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/peru-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Lima Stock Exchange (BVL)",
        "source": "TradingView screener (peru market), keyless",
        "country": "Peru",
        "indices": [
            "MXNUAMPEGEN",
            "MXNUAMPESEL"
        ],
        "currency": "PEN",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=CREDITC1,BBVAC1,BACKUAC1",
            "search": "/v1/search?q=banco",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Peru general index (MSCI NUAM Peru General)",
            "/v1/quote": "live quote for one or more BVL stocks by ticker (symbols=CREDITC1,BBVAC1)",
            "/v1/search": "find BVL stocks by company name (q, limit)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:18.253Z",
        "request_id": "60662faf-619d-477c-912c-3181efdc0da7"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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