Faiz Oranları API
TCMB EVDS, Fed ve ECB referans faizleri
Genel bakış
Faiz Oranları API; TCMB bir hafta vadeli repo (politika) faizi, gecelik borç alma/verme koridoru, TLREF ve EVDS’deki mevduat/kredi faiz ortalamalarını sunar. Fed Funds, ECB refi ve Euribor resmi istatistik kanallarından eklenir. Banka bazında kampanya oranları, ilgili banka protokolü olmadan yayımlanmaz.
Uç noktalar
Temel adres: https://api.apibir.com/v1
Kimlik doğrulama
Tüm isteklerde API anahtarınızı Authorization başlığında gönderin:
Authorization: apikey APIBIR-8f2c4b7e9a1d3c5f7b2e9d41
Accept: application/jsonSorgu parametreleri
| Parametre | Tip | Durum | Açıklama |
|---|---|---|---|
| country | string | opsiyonel | TR (varsayılan), US, EU, GB |
| type | string | opsiyonel | policy, deposit, loan, reference |
| product | string | opsiyonel | ihtiyac, konut, tasit, ticari |
| bank | string | opsiyonel | Banka kodu ile filtreleme |
| maturity | string | opsiyonel | Mevduat vadesi: 32, 92, 182, 365 gün |
Örnek istek
curl --request GET \
--url "https://api.apibir.com/v1/rates/policy?country=TR&type=teblig" \
--header "authorization: apikey APIBIR-8f2c...9d41" \
--header "content-type: application/json"package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apibir.com/v1/rates/policy?country=TR&type=teblig", nil)
req.Header.Add("authorization", "apikey APIBIR-8f2c...9d41")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}const https = require('https');
const options = {
hostname: 'api.apibir.com',
path: '/v1/rates/policy?country=TR&type=teblig',
method: 'GET',
headers: { 'authorization': 'apikey APIBIR-8f2c...9d41' }
};
https.get(options, (res) => {
let data = '';
res.on('data', (chunk) => data += chunk);
res.on('end', () => console.log(JSON.parse(data)));
});const res = await fetch(
"https://api.apibir.com/v1/rates/policy?country=TR&type=teblig",
{ headers: { authorization: "apikey APIBIR-8f2c...9d41" } }
);
const { data } = await res.json();
console.log(data);import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.apibir.com/v1/rates/policy?country=TR&type=teblig"))
.header("authorization", "apikey APIBIR-8f2c...9d41")
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());import requests
r = requests.get(
"https://api.apibir.com/v1/rates/policy?country=TR&type=teblig",
headers={"authorization": "apikey APIBIR-8f2c...9d41"},
timeout=10,
)
print(r.json()["data"])require 'net/http'
require 'uri'
uri = URI.parse("https://api.apibir.com/v1/rates/policy?country=TR&type=teblig")
request = Net::HTTP::Get.new(uri)
request["authorization"] = "apikey APIBIR-8f2c...9d41"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.bodyusing var client = new HttpClient();
client.DefaultRequestHeaders.Add("authorization", "apikey APIBIR-8f2c...9d41");
var json = await client.GetStringAsync("https://api.apibir.com/v1/rates/policy?country=TR&type=teblig");
Console.WriteLine(json);import Foundation
var request = URLRequest(url: URL(string: "https://api.apibir.com/v1/rates/policy?country=TR&type=teblig")!)
request.addValue("apikey APIBIR-8f2c...9d41", forHTTPHeaderField: "authorization")
let task = URLSession.shared.dataTask(with: request) { data, _, _ in
if let data = data, let str = String(data: data, encoding: .utf8) {
print(str)
}
}
task.resume()open Cohttp_lwt_unix
open Lwt
let uri = Uri.of_string "https://api.apibir.com/v1/rates/policy?country=TR&type=teblig" in
let headers = Header.init_with "authorization" "apikey APIBIR-8f2c...9d41" in
Client.get ~headers uri >>= fun (resp, body) ->
Cohttp_lwt.Body.to_string body >>= fun body_str ->
Lwt_io.printl body_str<?php
$ch = curl_init("https://api.apibir.com/v1/rates/policy?country=TR&type=teblig");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["authorization: apikey APIBIR-8f2c...9d41"]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data["data"]);Örnek yanıt
{
"success": true,
"creditsUsed": 1,
"timestamp": "2026-08-07T10:42:20+03:00",
"data": {
"policy": [
{
"country": "TR",
"institution": "TCMB",
"name": "1 Hafta Vadeli Repo",
"rate": 34.50,
"previousRate": 36.00,
"changeBps": -150,
"effectiveDate": "2026-07-24",
"nextMeeting": "2026-09-11"
},
{
"country": "US",
"institution": "Federal Reserve",
"name": "Fed Funds Target (üst bant)",
"rate": 3.75,
"previousRate": 4.00,
"changeBps": -25,
"effectiveDate": "2026-07-30"
}
],
"reference": [
{ "name": "TLREF", "rate": 33.87, "date": "2026-08-06" },
{ "name": "Euribor 3M", "rate": 2.14, "date": "2026-08-06" }
],
"loan": [
{
"product": "ihtiyac",
"bank": "Ortalama (sektör)",
"monthlyRate": 3.29,
"annualCostRate": 47.62,
"term": 36,
"date": "2026-08-06"
}
]
}
}Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
| rate | number | Yıllık yüzde oran |
| changeBps | number | Baz puan cinsinden değişim |
| effectiveDate | date | Oranın yürürlüğe girdiği tarih |
| nextMeeting | date | Bir sonraki para politikası toplantısı |
| annualCostRate | number | Yıllık maliyet oranı (kredi ürünleri) |
Kredi tüketimi: Bu servis her başarılı istek için 1 kredi harcar.
Hatalı istekler (4xx) kredi düşürmez. Kalan krediniz her yanıtın creditsRemaining alanında döner.
Olası hatalar
| Kod | HTTP | Anlamı |
|---|---|---|
| invalid_api_key | 401 | Anahtar geçersiz veya başlık eksik. |
| insufficient_credits | 402 | Aylık kredi limitiniz doldu. |
| invalid_parameter | 422 | Parametre değeri beklenen formatta değil. |
| rate_limited | 429 | Saniyelik istek limiti aşıldı. |
| no_data | 404 | Sorgu kriterlerine uyan kayıt bulunamadı. |
Bu API ile neler yapabilirsiniz?
Kredi hesaplama araçları
Sitenizdeki kredi hesaplayıcısını güncel banka oranlarıyla besleyin.
Karşılaştırma platformları
Mevduat ve kredi oranlarını banka bazında sıralayarak affiliate akışı kurun.
Hazine ve nakit yönetimi
TLREF'e endeksli sözleşmelerin faiz tahakkukunu otomatik hesaplayın.
Makro izleme panoları
Politika faizi, enflasyon ve kur değişimini tek grafikte izleyin.
AI ile hızlı başlangıç. Bu API'yi Claude'a tanıtıp tek promptla pano kurmak için AI & Dashboard rehberine bakın. Hazır prompt şablonu ve çalışan dashboard örneği orada.
İlgili API'ler
Döviz Kurları
Finans & PiyasaTCMB resmi günlük alış/satış kurları (EVDS ve kur bülteni). Muhasebe ve fatura değerlemesi için.
Ekonomik Takvim
Finans & PiyasaEnflasyon, faiz kararı, istihdam gibi veri açıklamaları; beklenti, önceki ve gerçekleşen değerler.
Geçmiş Döviz Kurları
Finans & PiyasaTCMB EVDS tarihsel kur arşivi.
Finansal Takip & Faiz Bülteni Hizmeti
TCMB faiz kararlarını ve banka mevduat/kredi faiz güncellemelerini anında mobil bildirim veya mail olarak alın.