Ana Sayfa / API Kataloğu / Ekonomik Takvim API

Ekonomik Takvim API

Piyasayı hareketlendiren tüm veri açıklamaları

Finans & PiyasaJSONGüncelleme: Anlık (açıklama anında)100 kredi / ay (ücretsiz plan)

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

GET/calendar/eventsTarih aralığındaki ekonomik olaylar
GET/calendar/todayBugünün takvimi
GET/calendar/indicatorsGösterge sözlüğü ve tarihçesi
POST/calendar/webhooksAçıklama anında bildirim aboneliği

Kimlik doğrulama

Tüm isteklerde API anahtarınızı Authorization başlığında gönderin:

Authorization: apikey APIBIR-8f2c4b7e9a1d3c5f7b2e9d41
Accept: application/json

Sorgu parametreleri

ParametreTipDurumAçıklama
startdateopsiyonelBaşlangıç tarihi. Varsayılan: bugün
enddateopsiyonelBitiş tarihi. Varsayılan: bugün + 7 gün
countriesstringopsiyonelÖrn: TR,US,EU
importancestringopsiyonellow, medium, high
currencystringopsiyonelEtkilediğ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.body
using 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ı

AlanTipAçıklama
datetimedatetimeAçıklama zamanı (ISO-8601, seçilen saat diliminde)
importancestringBeklenen piyasa etkisi seviyesi
actual / forecast / previousnumberGerçekleşen, beklenti ve önceki dönem
surprisenumberGerçekleşen ile beklenti farkı
impactstringpositive · 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

KodHTTPAnlamı
invalid_api_key401Anahtar geçersiz veya başlık eksik.
insufficient_credits402Aylık kredi limitiniz doldu.
invalid_parameter422Parametre değeri beklenen formatta değil.
rate_limited429Saniyelik istek limiti aşıldı.
no_data404Sorgu 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.

Piyasa Takip & Makroekonomik Bülten Otomasyonu

Kritik veri açıklamaları (enflasyon, faiz, büyüme) açıklandığı anda bildirim olarak ekranınıza gelsin.

Otomasyonları Gör