{"name":"Stock Price API","version":"2.0.0","description":"Stock market data API backed by SAHMK (Tadawul-licensed, https://www.sahmk.sa)","endpoints":[{"path":"/:ticker","method":"GET","description":"Returns ONLY the current price as a plain text string. Safe for Google Sheets IMPORTDATA.","example":"/2222","response":"text/plain — e.g. \"26.06\"","errors":"404 plain text for unknown/invalid tickers; 502 on upstream failure"},{"path":"/api/quote/:ticker","method":"GET","description":"Full quote data as JSON (currentPrice, change, changePercent, high, low, open, previousClose, volume)","example":"/api/quote/2222"},{"path":"/api/company/:ticker","method":"GET","description":"Company info (symbol, name, exchange, currency)","example":"/api/company/2222"},{"path":"/health","method":"GET","description":"Health check — returns 200 OK"}],"note":"Data source is Tadawul-licensed (SAHMK). Tickers are the plain Tadawul symbol number (e.g. 2222 for Aramco), no .SR suffix. Search and historical data require a paid SAHMK plan and return 501 on the free tier.","dataSource":"SAHMK (https://www.sahmk.sa)","rateLimit":{"priceEndpoint":"60 requests per minute per IP","global":"200 requests per 15 minutes per IP","sahMk":"100 requests/day on the free plan"},"cors":"Permissive — all origins allowed","envVars":{"SAHMK_API_KEY":"Required. SAHMK API key (provisioned via per-stack .env)","PORT":"Optional. Port to listen on (default: 3000)"}}