Ekonomik Takvim API
Piyasayı hareketlendiren tüm veri açıklamaları
Genel bakış
Ekonomik Takvim API; TÜFE/ÜFE, işsizlik, GSYH, PMI, faiz kararı, ticaret dengesi gibi makro veri açıklamalarının tarih-saatini, önem derecesini, piyasa beklentisini, önceki dönem değerini ve açıklandığında gerçekleşen değeri sunar. Ülke, para birimi ve önem seviyesine göre filtrelenebilir; webhook ile açıklama anında bildirim alınabilir.
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 |
|---|---|---|---|
| start | date | opsiyonel | Başlangıç tarihi. Varsayılan: bugün |
| end | date | opsiyonel | Bitiş tarihi. Varsayılan: bugün + 7 gün |
| countries | string | opsiyonel | Örn: TR,US,EU |
| importance | string | opsiyonel | low, medium, high |
| currency | string | opsiyonel | Etkilediği para birimi ile filtreleme |
Örnek istek
curl --request GET \
--url "https://api.apibir.com/v1/calendar/events?start=2026-07-01&end=2026-07-31" \
--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/calendar/events?start=2026-07-01&end=2026-07-31", 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/calendar/events?start=2026-07-01&end=2026-07-31',
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/calendar/events?start=2026-07-01&end=2026-07-31",
{ 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/calendar/events?start=2026-07-01&end=2026-07-31"))
.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/calendar/events?start=2026-07-01&end=2026-07-31",
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/calendar/events?start=2026-07-01&end=2026-07-31")
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/calendar/events?start=2026-07-01&end=2026-07-31");
Console.WriteLine(json);import Foundation
var request = URLRequest(url: URL(string: "https://api.apibir.com/v1/calendar/events?start=2026-07-01&end=2026-07-31")!)
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/calendar/events?start=2026-07-01&end=2026-07-31" 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/calendar/events?start=2026-07-01&end=2026-07-31");
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,
"timezone": "Europe/Istanbul",
"data": [
{
"id": "tr-cpi-2026-08",
"datetime": "2026-08-03T10:00:00+03:00",
"country": "TR",
"currency": "TRY",
"event": "TÜFE (Yıllık)",
"indicator": "cpi_yoy",
"importance": "high",
"period": "Temmuz 2026",
"actual": 28.4,
"forecast": 29.1,
"previous": 30.6,
"unit": "%",
"surprise": -0.7,
"impact": "positive"
},
{
"id": "us-nfp-2026-08",
"datetime": "2026-08-07T15:30:00+03:00",
"country": "US",
"currency": "USD",
"event": "Tarım Dışı İstihdam",
"indicator": "nfp",
"importance": "high",
"period": "Temmuz 2026",
"actual": null,
"forecast": 148000,
"previous": 132000,
"unit": "kişi"
}
]
}Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
| datetime | datetime | Açıklama zamanı (ISO-8601, seçilen saat diliminde) |
| importance | string | Beklenen piyasa etkisi seviyesi |
| actual / forecast / previous | number | Gerçekleşen, beklenti ve önceki dönem |
| surprise | number | Gerçekleşen ile beklenti farkı |
| impact | string | positive · negative · neutral |
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?
Trading platformları
Yüksek etkili veri öncesi kullanıcıyı uyarın, spread genişlemesini yönetin.
Haber otomasyonu
Veri açıklandığı anda otomatik haber metni ve grafik üretin.
Hazine planlaması
Faiz kararı ve enflasyon tarihlerini nakit planına işleyin.
Yatırımcı bültenleri
Haftalık takvim özetini otomatik e-postayla gönderin.
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
Faiz Oranları
Finans & PiyasaTCMB politika faizi, mevduat/kredi faizleri, TLREF, Euribor, Fed ve ECB oranları.
Döviz Kurları
Finans & PiyasaTCMB resmi günlük alış/satış kurları (EVDS ve kur bülteni). Muhasebe ve fatura değerlemesi için.
Resmi Gazete & Mevzuat
Mevzuat & KamuGünlük Resmi Gazete kararları ve mevzuat değişiklikleri.
Piyasa Takip & Makroekonomik Bülten Otomasyonu
Kritik veri açıklamaları (enflasyon, faiz, büyüme) açıklandığı anda bildirim olarak ekranınıza gelsin.