# BYMA Argentina Stock Exchange API
> Live data from BYMA (Bolsas y Mercados Argentinos), the Argentine exchange, with no key. Read the live value of every BYMA index — the S&P MERVAL, the S&P BYMA General and the BYMA CEDEAR index among them — with level, change and VWAP; look up a single index; pull the public-bond market with prices, maturities and days-to-maturity (Argentine sovereign and public bonds); and look up a single bond. The Argentina-equities-index / sovereign-bond layer for trading dashboards, screeners and research — distinct from other exchange readers, this is BYMA index and bond data. Live from the BYMA free API; short cache only.

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

## Pricing
- **Free** (Free) — 15,000 calls/Mo, 3 req/s
- **Starter** ($18/Mo) — 300,000 calls/Mo, 8 req/s
- **Pro** ($47/Mo) — 1,650,000 calls/Mo, 20 req/s
- **Enterprise** ($112/Mo) — 8,400,000 calls/Mo, 60 req/s

## Endpoints

### Indices

#### `GET /v1/index` — A single BYMA index by symbol

**Parameters:**
- `symbol` (query, required, string) — Index symbol, e.g. M (S&P MERVAL), G (BYMA General) Example: `M`

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

**Response:**
```json
{
    "data": {
        "note": "One BYMA index by symbol — level, previous close, percent change, day high/low and VWAP. Pass symbol (e.g. M for the S&P MERVAL).",
        "index": {
            "low": 3341045.1,
            "high": 3390505.03,
            "name": "S&P MERVAL",
            "vwap": 0,
            "value": 3352707.61,
            "symbol": "M",
            "change_percent": -0.01,
            "previous_close": 3353007.69
        },
        "source": "BYMA"
    },
    "meta": {
        "timestamp": "2026-06-15T02:11:00.138Z",
        "request_id": "0d8548c2-1561-40a1-99ae-143d420eb02e"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

#### `GET /v1/indices` — Every BYMA index (MERVAL & more)

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

**Response:**
```json
{
    "data": {
        "note": "The live value of every BYMA index — the S&P MERVAL, the S&P BYMA General, the BYMA CEDEAR index and the sector indices — each with its level, previous close, percent change, day high/low and VWAP. The pulse of the Argentine market.",
        "count": 16,
        "source": "BYMA",
        "indices": [
            {
                "low": 141278473.77,
                "high": 143754571.52,
                "name": "S&P BYMA Indice General",
                "vwap": 0,
                "value": 141818825.8,
                "symbol": "G",
                "change_percent": -0.29,
                "previous_close": 142230571.66
            },
            {
                "low": 3341045.1,
                "high": 3390505.03,
                "name": "S&P MERVAL",
                "vwap": 0,
                "value": 3352707.61,
                "symbol": "M",
                "change_percent": -0.01,
                "previous_close": 3353007.69
            },
            {
                "low": 46513.21,
                "high": 47786.76,
                "name": "S&P BYMA Construccion",
                "vwap": 0,
                "value": 46932.33,
                "symbol": "SPBYCAP",
                "change_percent": -0.15,
                "previous_close": 47004.99
            },
            {
                "low": 41699.69,
                "high": 42555,
                "name": "S&P BYMA CEDEAR Index",
                "vwap": 0,
                "valu
…(truncated, see openapi.json for full schema)
```

### Bonds

#### `GET /v1/bond` — A single public bond by symbol

**Parameters:**
- `symbol` (query, required, string) — Bond symbol, e.g. AE38, GD30 Example: `AE38`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/byma-api/v1/bond?symbol=AE38"
```

**Response:**
```json
{
    "data": {
        "bond": {
            "name": null,
            "vwap": 120873.5100931,
            "price": 120700,
            "symbol": "AE38",
            "currency": "ARS",
            "day_high": 121700,
            "trade_volume": 3747516,
            "maturity_date": "2038-01-09",
            "opening_price": 120000,
            "previous_close": 120490,
            "days_to_maturity": 4227
        },
        "note": "One BYMA public bond by symbol — price, previous close, opening price, day high, VWAP, volume, maturity date and days to maturity. Pass symbol (e.g. AE38, GD30).",
        "source": "BYMA"
    },
    "meta": {
        "timestamp": "2026-06-15T02:11:00.945Z",
        "request_id": "5544576a-9eb9-41e8-b75a-8e72d29d6f82"
    },
    "status": "ok",
    "message": "Bond retrieved successfully",
    "success": true
}
```

#### `GET /v1/bonds` — The public-bond market

**Parameters:**
- `sort` (query, optional, string) — symbol (default), volume or maturity Example: `maturity`
- `limit` (query, optional, string) — Results (1-200, default 50) Example: `50`
- `offset` (query, optional, string) — Pagination offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/byma-api/v1/bonds?sort=maturity&limit=50&offset=0"
```

**Response:**
```json
{
    "data": {
        "note": "The BYMA public-bond market — Argentine sovereign and public bonds, each with its price, previous close, opening price, day high, VWAP, volume, maturity date and days to maturity. Sort by symbol (default), volume or maturity; page with offset and limit (max 200).",
        "sort": "maturity",
        "bonds": [
            {
                "name": null,
                "vwap": 0,
                "price": 104,
                "symbol": "BL26X",
                "currency": "ARS",
                "day_high": 0,
                "trade_volume": 0,
                "maturity_date": "2026-07-14",
                "opening_price": 0,
                "previous_close": 104,
                "days_to_maturity": 30
            },
            {
                "name": null,
                "vwap": 1,
                "price": 0,
                "symbol": "BL2L6.SB",
                "currency": "ARS",
                "day_high": 0,
                "trade_volume": 0,
                "maturity_date": "2026-07-17",
                "opening_price": 0,
                "previous_close": 0,
                "days_to_maturity": 33
            },
            {
                "name": null,
                "vwap": 0,
                "price": 133246.8103,
                "symbol": "AL03A",
                "currency": "ARS",
                "day_high": 0,
                "trade_volume": 0,
                "maturity_date": "2026-09-08",
                "opening_price": 0,
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Endpoints & source

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

**Response:**
```json
{
    "data": {
        "sample": {
            "merval": 3352707.61
        },
        "source": "BYMA public free market API (open.bymadata.com.ar), keyless",
        "service": "byma-api",
        "endpoints": {
            "GET /v1/bond": "One public bond by symbol (symbol).",
            "GET /v1/meta": "This document.",
            "GET /v1/bonds": "The public-bond market (sort, limit).",
            "GET /v1/index": "One index by symbol (symbol).",
            "GET /v1/indices": "Every BYMA index (MERVAL, BYMA General, CEDEAR…)."
        },
        "description": "Live data from BYMA (Bolsas y Mercados Argentinos) with no key: the live value of every BYMA index (S&P MERVAL, S&P BYMA General, CEDEAR index and sector indices), a single index lookup, the public-bond market with prices and maturities (Argentine sovereign and public bonds), and a single bond lookup. The Argentina-equities-index / sovereign-bond layer for trading dashboards and screeners. Distinct from other exchange readers — BYMA index and bond data. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:11:01.117Z",
        "request_id": "9e6e9423-5394-45d2-86c0-94de3063aeeb"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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