/v1/screener
Ranked market screener (primary Tunisian listings)
Try it live
10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.
It works. Grab an API key and use it in your project.
Get an API keyCode snippets
curl "https://api.oanor.com/tunisia-stock-api/v1/screener" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tunisia-stock-api/v1/screener", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tunisia-stock-api/v1/screener");
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/tunisia-stock-api/v1/screener",
headers={"x-oanor-key": "oanor_test_..."}
)
Example response
A real response from this endpoint, captured by the latest health check.
{
"data": {
"by": "marketcap",
"note": "A ranked screener of the Tunisian (BVMT) market — the top stocks by your chosen ranking, limited to primary Tunisian listings. Pass by (gainers, losers, active, or marketcap; default marketcap) and limit (1-100, default 20).",
"count": 20,
"source": "Tunis Stock Exchange / BVMT (TradingView)",
"results": [
{
"price": 159.48,
"change": 0,
"sector": "Finance",
"ticker": "BIAT",
"volume": 656,
"company": "Banque Internationale Arabe de Tunisie SA",
"currency": "TND",
"market_cap": 6506783704,
"change_percent": 0
},
{
"price": 28.2,
"change": 0.4499999999999993,
"sector": "Process Industries",
"ticker": "PGH",
"volume": 29561,
"company": "Poulina Group Holding SA",
"currency": "TND",
"market_cap": 5076101688,
"change_percent": 1.62
},
{
"price": 79.98,
"change": -0.009999999999990905,
"sector": "Finance",
"ticker": "TJARI",
"volume": 2624,
"company": "Banque Attijari de Tunisie SA",
"currency": "TND",
"market_cap": 3999000168,
"change_percent": -0.01
},
{
"price": 14.55,
"change": -0.75,
"sector": "Consumer Non-Durables",
"ticker": "SFBT",
"volume": 24239,
"company": "Societe de Fabrication des Boissons de Tunisie SA",
"currency": "TND",
"market_cap": 3901218801,
"change_percent": -4.9
},
{
"price": 72.7,
"change": 1.2000000000000028,
"sector": "Finance",
"ticker": "AB",
"volume": 17166,
"company": "Amen Bank",
"currency": "TND",
"market_cap": 2538683760,
"change_percent": 1.68
},
{
"price": 8.4,
"change": 0.08000000000000007,
"sector": "Finance",
"ticker": "BT",
"volume": 106189,
"company": "Banque de Tunisie SA",
"currency": "TND",
"market_cap": 2267999897,
"change_percent": 0.96
},
{
"price": 19.98,
"change": 0.08000000000000185,
"sector": "Distribution Services",
"ticker": "DH",
"volume": 16718,
"company": "Delice Holding SA",
"currency": "TND",
…