Temel veriler, oranlar, mali tablolar ve temettüler — artı AAOIFI uyumluluk kararı — tek bir REST çağrısından veya tek bir MCP aracından. Her sayı birden çok bağımsız kaynakla (SEC EDGAR, Yahoo, Finnhub) çapraz doğrulanır; iki kaynağın altındaki her şey doğrulanmamış olarak işaretlenir. Körfez ve ABD piyasaları, 7 dil, ajan-yerel.

Ücretsiz bir hesapla 3 ay boyunca ücretsiz — her kontrole, Zekât araçlarına ve API + MCP sunucusuna tam erişim. Kart gerekmez; ücretli planlar lansman döneminden sonra başlar. Aşağıdaki tablodaki plan etiketleri gelecekteki fiyatlandırmayı gösterir; lansman döneminde ücret alınmaz.

Ücretsiz hesabınızı oluşturun Ajan Beceri dosyası

import { HalalStock, HalalStockError } from "./halalstock.js";

// key from your account (starts with thl_); keyless works too but is IP-metered
const hs = new HalalStock(process.env.HALALSTOCK_API_KEY);

try {
  const v = await hs.check("AAPL");            // GET /v1/stock/AAPL/halal
  // status is a screening result, not a fatwa — read it with confidence
  console.log(v.status, v.compliance_score, v.confidence);
  console.log(v.disclaimer);                   // always relay this to the user

  const res = await hs.screen(["AAPL", "TSLA", "2222.SR"]);  // batch, up to 25
  console.log(res.count, "screened");
} catch (e) {
  if (e instanceof HalalStockError) console.error(e.status, e.detail);
}

# public — no key needed (metered per IP)
curl "https://halalstock.net/v1/stock/AAPL/halal?profile=standard"

# with your key (starts with thl_) for a higher quota
curl "https://halalstock.net/v1/stock/2222.SR/halal" \
  -H "Authorization: Bearer $HALALSTOCK_API_KEY"

# batch screen up to 25 tickers
curl "https://halalstock.net/v1/screen?symbols=AAPL,TSLA,2222.SR" \
  -H "Authorization: Bearer $HALALSTOCK_API_KEY"

# add to your MCP client config (e.g. Claude Desktop)
{
  "mcpServers": {
    "halalstock": {
      "command": "python",
      "args": ["-m", "tahleel.mcp_server"],
      "env": {
        "HALALSTOCK_API_URL": "https://halalstock.net",
        "HALALSTOCK_API_KEY": "thl_your_key"
      }
    }
  }
}
# then just ask: "Is Aramco (2222.SR) halal?" — the agent calls check_halal()