Search the market by name or ticker

Code snippets

curl "https://api.oanor.com/nairobi-stock-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/nairobi-stock-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/nairobi-stock-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/nairobi-stock-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Search the Kenyan (NSE) market by company name or ticker — matching stocks ranked by market cap. Pass q (the name or ticker fragment, e.g. bank), optionally sector (e.g. Finance, Communications) and limit (1-50, default 20).",
        "count": 4,
        "query": "bank",
        "sector": "Finance",
        "source": "Nairobi Securities Exchange / NSE Kenya (TradingView)",
        "results": [
            {
                "price": 31.8,
                "change": 0.6999999999999993,
                "sector": "Finance",
                "ticker": "COOP",
                "volume": 981116,
                "company": "Co-operative Bank of Kenya Ltd.",
                "currency": "KES",
                "market_cap": 185989430306,
                "change_percent": 2.25
            },
            {
                "price": 28.9,
                "change": 0.3999999999999986,
                "sector": "Finance",
                "ticker": "ABSA",
                "volume": 853065,
                "company": "Absa Bank Kenya Plc",
                "currency": "KES",
                "market_cap": 153169323089,
                "change_percent": 1.4
            },
            {
                "price": 336,
                "change": 1,
                "sector": "Finance",
                "ticker": "SCBK",
                "volume": 12309,
                "company": "Standard Chartered Bank Kenya Ltd",
                "currency": "KES",
                "market_cap": 127339370422,
                "change_percent": 0.3
            },
            {
                "price": 142,
                "change": -1,
                "sector": "Finance",
                "ticker": "DTK",
                "volume": 31977,
                "company": "Diamond Trust Bank Kenya Ltd.",
                "currency": "KES",
                "market_cap": 39843318329,
                "change_percent": -0.7
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:30.889Z",
        "request_id": "0dc0d9ea-aefb-491d-bb0d-d4e03b72ab4c"
    },
    "status": "ok",
    "message": "Search retrieved successfully",
    "success": true
}