Dönem istatistikleri

Deneme Alanı'nda deneyin →

Kimlikler her zamanki kanonik biçimdedir. Hangi üst-kaynak varlık tipinin yanıtladığı sizin için çözülür ve yanıt bunu açıkça söyler:

• bist:THYAO — BIST hisseleri ve borsa yatırım fonları (BYF'leri listeleyin: /v1/instruments?market=bist&asset_type=ETF&limit=100)
• us:IBM — ABD hisseleri ve ETF'ler
• fund:IBM — Türkiye yatırım fonları (TEFAS)
• cmdty:XGLD — Altın ve diğer emtialar
• XU100 — 30 BIST endeksi — kendi uç noktasında, kodla
• kimya — 47 Portfoy sektörü — slug ile

Null, sıfır değildir. Üst kaynak hesaplayamadığı bir değeri 0 yazmak yerine hiç yazmaz; biz de bunu null olarak geçiririz — yani null “değer yok”, 0 ise sayının gerçekten sıfır olduğu anlamına gelir.

Her zaman calculated_at alanını okuyun. Bu satırlar borsa zaman damgası taşımaz, yalnızca yazıcının kendi damgasını taşır; dolayısıyla taze bir satırı donmuş bir satırdan ayıran tek sinyal budur. Hisseler ve endeksler yaklaşık 15 dakikada bir, fonlar 6 saatte bir, sektörler saatlik yeniden hesaplanır.

Eksik bir satır 404'tür, uydurulmuş bir tahmin değil. Bir fiyat akışı bir tur boş döndüğünde enstrümanlar geçici olarak satırsız kalabilir; bu yüzden 404'ü “hiçbir zaman” değil “şu anda değil” olarak yorumlayın.

veri ve tazelik politikası

Tüm sayısal değerler JSON string tipindedir; böylece size ulaşana kadar hassasiyet kaybolmaz. Float değil, ondalık (decimal) olarak ayrıştırın.

Her yanıt artık currency alanını taşır: current_price ile her pencerenin high, low, start_price ve change_nominal alanlarının para birimi. Bu alanları güncel spot kurla çevirmek için ?currency=TRY, USD veya EUR ekleyin (tekli ya da toplu); kullanılan kur fx_rate ve fx_as_of ile bildirilir. change_pct bir yüzdedir ve asla çevrilmez. Toplu istekte her yerel para birimi için bir kur alınır.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/periodic/bist:THYAO?currency=USD"
# → {"instrument_id": "bist:THYAO", "currency": "USD", "current_price": "…",
#    "periods": {…high/low/start_price/change_nominal in USD, change_pct unchanged…},
#    "fx_rate": "…", "fx_as_of": "…"}

En fazla 100 kimliği /v1/periodic?ids= uç noktasına verin. Piyasalar karışık olabilir. Satırı olmayan kimlikler, çağrının tamamını başarısız kılmak yerine not_found dizisinde döner; böylece kotasyondan çıkmış tek bir sembol diğer 99'una mal olmaz. Toplu istekler istek başına değil, enstrüman başına ölçülür.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/periodic?ids=us:IBM,fund:IBM,bist:ZPX30F"

{
  "stats": [
    { "instrument_id": "us:IBM",   "asset_type": "US_STOCK",
      "current_price": "231.835",  "periods": { /* as above */ } },
    { "instrument_id": "fund:IBM", "asset_type": "FUND",
      "current_price": "3.905547", "periods": { /* a different row */ } }
  ],
  "not_found": ["bist:ZPX30F"]
}

Bu, şununla aynı değer değildir: /v1/sectors/{code}/returns. O uç nokta, sektör endeks değerlerinden bir oran olarak burada hesaplanır ve 1w/1m/3m/6m/ytd/1y döneminde çalışır. Bu uç nokta ise üst kaynağın sektör bileşenlerinin ortalamasıdır; 1w/2w/1m/3m/6m/1y döneminde ve Türkiye ile ABD ayakları ayrı ayrı. İki farklı yöntem, aynı sayının iki görünümü değil — farklı çıkmalarını bekleyin ve yöntemi size uyanı seçin.

combined bloğunda bilinçli olarak fiyat alanı yoktur. Bir sektörün fiyatı olmaz; bu yüzden üst kaynağın oraya yazdığı yer tutucu sıfırlar yerine, pencerenin en iyi ve en kötü bileşen getirisini alırsınız.

Her ayak, getirisinin yanında bir sample_count gönderir: 40'ta 2'lik bir örneklem ile 40'ta 40'lık bir örneklem aynı iddia değildir. Aşağıdaki örnekte ABD ayağının 21 bildirdiğine dikkat edin; sektörün 22 ABD bileşeni var — birinin o pencere için kullanılabilir fiyatı yoktu.

{
  "code": "kimya", "name_tr": "Kimya", "sector_id": 21,
  "tr_constituent_count": 44, "us_constituent_count": 22,
  "calculation_date": "2026-08-25",
  "calculated_at": "2026-08-25T13:34:35.679277",
  "combined": {
    "1w": {"change_pct": "2.3122871174622417",
           "best_constituent_pct": "20.889748549323013",
           "worst_constituent_pct": "-12.90613718411552"}
  },
  "tr": {"1w": {"change_pct": "2.7418678795640044", "sample_count": 44}},
  "us": {"1w": {"change_pct": "1.4122131397252147", "sample_count": 21}}
}

Ayrıca bakınız: /docs/sectors · /docs/indices