# Cyprus Stock Exchange API
> Live equity market data for the Cyprus Stock Exchange (CSE), the regulated securities market in Nicosia, all priced in EUR. Pull real-time quotes for specific listings — Bank of Cyprus, Eurobank, Vassiliko Cement, Demetra Holdings and the rest of the board — with last price, day change percentage and absolute change, open, high, low, traded volume, market capitalisation and sector; run a ranked screener sorted by market cap, day change, volume or price; search the listings by company name; or read a market summary with the number of advancers, decliners and unchanged stocks, total market capitalisation and the day top gainer, top loser and most-active share. Distinct from other regional-exchange APIs on the marketplace — this surfaces the Cyprus Stock Exchange specifically (not the Colombo CSE).

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

## Pricing
- **Free** (Free) — 1,480 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 46,300 calls/Mo, 6 req/s
- **Pro** ($30/Mo) — 174,000 calls/Mo, 16 req/s
- **Scale** ($66/Mo) — 712,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

#### `GET /v1/quote` — Quotes for specific symbols

**Parameters:**
- `symbols` (query, required, string) — Comma-separated CSE symbols Example: `BOCH,EUROBCY`

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

**Response:**
```json
{
    "data": {
        "count": 2,
        "market": "Cyprus Stock Exchange",
        "quotes": [
            {
                "low": 9.7,
                "high": 9.855,
                "open": 9.8,
                "price": 9.7,
                "sector": "Finance",
                "symbol": "CSECY:BOCH",
                "ticker": "BOCH",
                "volume": 9952,
                "company": "Bank of Cyprus Holdings Plc",
                "currency": "EUR",
                "change_abs": -0.11000000000000121,
                "market_cap": 4183749705.9999995,
                "change_percent": -1.121304791029574
            },
            {
                "low": 4.2,
                "high": 4.2,
                "open": 4.2,
                "price": 4.2,
                "sector": "Finance",
                "symbol": "CSECY:EUROBCY",
                "ticker": "EUROBCY",
                "volume": 2712,
                "company": "EUROBANK S.A.",
                "currency": "EUR",
                "change_abs": 0.2360000000000002,
                "market_cap": 14753526458,
                "change_percent": 5.953582240161459
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:18.853Z",
        "request_id": "28b266d2-aec2-4bc7-b02c-00f77781428a"
    },
    "status": "ok",
    "message": "Quote retrieved successfully",
    "success": true
}
```

### Screener

#### `GET /v1/screener` — Ranked stock screener

**Parameters:**
- `sort` (query, optional, string) — market_cap_basic | change | volume | close Example: `market_cap_basic`
- `order` (query, optional, string) — asc | desc Example: `desc`
- `limit` (query, optional, string) — Max rows (1-50) Example: `20`

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

**Response:**
```json
{
    "data": {
        "sort": "market_cap_basic",
        "count": 20,
        "order": "desc",
        "total": 32,
        "market": "Cyprus Stock Exchange",
        "stocks": [
            {
                "low": 4.2,
                "high": 4.2,
                "open": 4.2,
                "price": 4.2,
                "sector": "Finance",
                "symbol": "CSECY:EUROBCY",
                "ticker": "EUROBCY",
                "volume": 2712,
                "company": "EUROBANK S.A.",
                "currency": "EUR",
                "change_abs": 0.2360000000000002,
                "market_cap": 14753526458,
                "change_percent": 5.953582240161459
            },
            {
                "low": 9.7,
                "high": 9.855,
                "open": 9.8,
                "price": 9.7,
                "sector": "Finance",
                "symbol": "CSECY:BOCH",
                "ticker": "BOCH",
                "volume": 9952,
                "company": "Bank of Cyprus Holdings Plc",
                "currency": "EUR",
                "change_abs": -0.11000000000000121,
                "market_cap": 4183749705.9999995,
                "change_percent": -1.121304791029574
            },
            {
                "low": 5,
                "high": 5.1,
                "open": 5.1,
                "price": 5,
                "sector": "Non-Energy Minerals",
                "symbol": "CSECY:VCW",
                "ticker": "VCW",
               
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search` — Search listings by company name

**Parameters:**
- `q` (query, required, string) — Company name query (min 2 chars) Example: `bank`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cyprus-stock-api/v1/search?q=bank"
```

**Response:**
```json
{
    "data": {
        "count": 2,
        "query": "bank",
        "market": "Cyprus Stock Exchange",
        "results": [
            {
                "low": 4.2,
                "high": 4.2,
                "open": 4.2,
                "price": 4.2,
                "sector": "Finance",
                "symbol": "CSECY:EUROBCY",
                "ticker": "EUROBCY",
                "volume": 2712,
                "company": "EUROBANK S.A.",
                "currency": "EUR",
                "change_abs": 0.2360000000000002,
                "market_cap": 14753526458,
                "change_percent": 5.953582240161459
            },
            {
                "low": 9.7,
                "high": 9.855,
                "open": 9.8,
                "price": 9.7,
                "sector": "Finance",
                "symbol": "CSECY:BOCH",
                "ticker": "BOCH",
                "volume": 9952,
                "company": "Bank of Cyprus Holdings Plc",
                "currency": "EUR",
                "change_abs": -0.11000000000000121,
                "market_cap": 4183749705.9999995,
                "change_percent": -1.121304791029574
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:19.299Z",
        "request_id": "c2e40412-3ed6-4a2e-8fd3-b24c654a6ac3"
    },
    "status": "ok",
    "message": "Search results retrieved successfully",
    "success": true
}
```

### Market

#### `GET /v1/market` — Market summary

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

**Response:**
```json
{
    "data": {
        "market": "Cyprus Stock Exchange",
        "currency": "EUR",
        "listings": 32,
        "advancers": 11,
        "decliners": 15,
        "top_loser": {
            "symbol": "CSECY:TOP",
            "company": "Top Kinisis Travel Public Limited",
            "change_percent": -9.696969696969706
        },
        "unchanged": 6,
        "top_gainer": {
            "symbol": "CSECY:MINE",
            "company": "Minerva Insurance Co Public Ltd.",
            "change_percent": 7.894736842105271
        },
        "most_active": {
            "symbol": "CSECY:ERME",
            "volume": 136000,
            "company": "Ermes Department Stores PLC"
        },
        "total_market_cap": 20878580514
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:19.511Z",
        "request_id": "186e69a2-695d-4404-8604-f8d3618f7a53"
    },
    "status": "ok",
    "message": "Market summary retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "name": "Cyprus Stock Exchange API",
        "market": "Cyprus Stock Exchange (CSE)",
        "currency": "EUR",
        "endpoints": [
            {
                "path": "/v1/quote",
                "description": "Quotes for specific symbols (?symbols=BOCH,EUROBCY)"
            },
            {
                "path": "/v1/screener",
                "description": "Ranked stocks (?sort=market_cap_basic|change|volume&order=desc&limit=)"
            },
            {
                "path": "/v1/search",
                "description": "Search listings by company name (?q=bank)"
            },
            {
                "path": "/v1/market",
                "description": "Market summary: advancers/decliners, total cap, top movers"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "namespace": "CSECY",
        "disclaimer": "Unofficial market data via the public TradingView screener. Not affiliated with the Cyprus Stock Exchange or TradingView. Delayed/indicative data; not investment advice.",
        "description": "Live equity quotes, a ranked screener, company search and a market summary for the Cyprus Stock Exchange (CSE), priced in EUR."
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:19.605Z",
        "request_id": "45b498a6-4eb8-4e98-9c2a-a06e77b75c6f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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