ABD hisseleri & ETF'ler

ABD hisseleri & ETF'ler (~1.600 enstrüman: 1.250 adi hisse, 313 ETF, 29 ADR): 15 dakika gecikmeli fiyatlar, seans dışı gün içi barlar, günlük geçmiş, şirket profilleri ve temettüler.

Uç noktalar

Uç nokta	Kapsam	Açıklama
GET/v1/quotes/us:{SYM}	quotes:us	Tek fiyat (toplu: GET /v1/quotes?ids=…)
GET/v1/candles/us:{SYM}?resolution=5m\|1d	history	Seans öncesi/sonrası dahil 5dk barlar (yaklaşık son 7 gün) veya günlük
GET/v1/eod/us:{SYM}?from=&to=	history	Gün sonu kayıtları (2024'ten itibaren geçmiş)
GET/v1/stocks/us:{SYM}/profile	quotes:us	Şirket/ETF referansı: açıklama (EN+TR), piyasa değeri, SIC sektörü, borsa, çalışan sayısı
GET/v1/stocks/us:{SYM}/dividends	history	Nakit dağıtımlar: tutar, temettü kesim tarihi, ödeme tarihi, sıklık, verim
GET/v1/dividends?market=us&from=&to=&date_field=&status=&symbols=	history	Tüm ABD piyasasının bir tarih aralığındaki temettüleri (hak kullanım ya da ödeme tarihi), sayfalı
GET/v1/markets/us/status	any key	NYSE seans saati (09:30–16:00 ET, tam tatil takvimi)
GET/v1/markets/us/movers	quotes:us	Yükselenler / düşenler / en çok işlem görenler
GET/v1/stocks/us:{SYM}/indicators?indicators=&periods=	history	Kendi barlarımız üzerinde teknik göstergeler (RSI, MACD, Bollinger, SMA/EMA, ATR/ADX/Stochastic)
GET/v1/stocks/us:{SYM}/financials?timeframe=annual\|quarterly\|ttm	history	SEC'e sunulan finansal tablolar (gelir / bilanço / nakit akışı / kapsamlı gelir)
GET/v1/stocks/us:{SYM}/valuation	history	Son değerleme görüntüsü: piyasa değeri, F/K, PD/DD (hesaplanan)

Deneme Alanı'nda deneyin →

Teknik göstergeler

Kendi ABD barlarımız üzerinde on gösterge — RSI, MACD, Bollinger, SMA, EMA (+ ROC, OBV, ATR, ADX, Stochastic). Varsayılan set (rsi,macd,bbands,sma,ema; periyotlar 20/50/200) günlük önceden hesaplanır ve anında sunulur; özel seçimler anlık hesaplanır. Geri doldurulan günlük barlar bar bazlı yüksek/düşük taşır, bu yüzden ATR/ADX/Stochastic 1g'de çözülür; canlı dönem barları o/y/d'yi null bırakır — bunlar için resolution=5m kullanın.

curl — MACD + RSI, daily

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/stocks/us:AAPL/indicators?indicators=macd,rsi"

Finansal tablolar

SEC'e sunulan gelir tablosu, bilanço, nakit akışı ve kapsamlı gelir (lisanslı veri dağıtıcısı aracılığıyla). timeframe=annual|quarterly|ttm; değerler tam USD'dir, en yeni önce.

curl — last 4 annual periods

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/stocks/us:AAPL/financials?timeframe=annual&limit=4"

Değerleme (son durum)

BIST'teki /valuation uç noktasının aynısı, ABD hisseleri için — yalnızca son durum (ABD değerleme geçmişi yoktur; /valuation/history yalnızca bist: içindir ve burada 404 döner). Piyasa değeri günlük ticker-details satırından gelir (as_of onun güncellenme zamanıdır). F/K = piyasa değeri ÷ ana ortaklığa ait en yeni son on iki ay (TTM) net kârı; bu TTM satırı en yeni çeyreğin gerisinde kalabilir, hangisinin kullanıldığını source_period söyler. PD/DD = piyasa değeri ÷ en yeni çeyreklik bilançodaki ana ortaklığa ait özkaynak. TTM net kâr sıfır veya negatifse F/K null'dır.

curl — AAPL valuation (scope: history)

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/stocks/us:AAPL/valuation"

response (abridged)

{
  "instrument_id": "us:AAPL", "market": "us", "currency": "USD",
  "source": "licensed-distributor",
  "as_of": "2026-07-10T21:00:00Z", "data_date": null,
  "market_cap": {"value": "4644435714320", "null_reason": null},
  "pe_ratio": {"value": "37.89", "source_period": "ttm#2026-03-28", "period_end": "2026-03-28",
               "inputs": {"market_cap": "4644435714320",
                          "net_income_attributable_to_parent_ttm": "122575000000"}},
  "pb_ratio": {"value": "43.20", "source_period": "quarterly#2026-06-27",
               "inputs": {"market_cap": "4644435714320",
                          "equity_attributable_to_parent": "107520000000"}},
  "ebitda": {"value": null,
             "null_reason": "depreciation & amortization not provided by source for us: statements"},
  "net_debt": {"value": null,
               "null_reason": "cash and short-term debt lines not provided by source for us: statements"},
  "eps_growth_pct": {"value": null,
                     "null_reason": "only the newest TTM statement is stored upstream for us: — no prior-year TTM to compare"},
  …,
  "coverage_from": null
}

ABD tabloları amortisman, nakit ya da kısa vadeli borç kalemlerini taşımaz ve üst kaynakta tek bir TTM satırı saklanır — bu yüzden us: kimliklerinde ebitda, ebitda_ttm, net_debt, ev, ev_ebitda, eps_growth_pct ve peg her zaman null'dır ve her biri bir null_reason taşır. coverage_from null'dır. Para birimi USD'dir.

Seans dışı barlar

ABD 5 dakikalık barları bir session etiketi taşır — pre / regular / post — ve yaklaşık 07:00–20:00 ET aralığını kapsar. Zaman damgaları UTC'dir.

curl — today's pre-market so far

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/candles/us:AAPL?resolution=5m" \
  | jq '[.bars[] | select(.session == "pre")]'

Ne null ve neden

Canlı fiyatta open/high/low değerleri null olur: kaynak akış burada seansın değil, son 1 dakikalık barın değerlerini taşır ve biz bunları yanlış raporlamayız. Gün volume (adet) ve turnover (≈ hacim × gün VWAP, USD) gerçektir. Yakın günlük barlar aynı nedenle o/y/d alanlarını null bırakır — eski geçmiş (geri dolduruldu) tam OHLC içerir. Kapanışlar, hacim ve değişim %'si her yerde tamdır.

Null alanlar felsefesinin tamamı ve piyasa bazlı gecikme tablosu: Veri ve tazelik politikası.

Temettüler

curl

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/stocks/us:AAPL/dividends?limit=4"

response (abridged)

{
  "instrument_id": "us:AAPL",
  "dividends": [
    {"declaration_date": "2026-01-29", "ex_dividend_date": "2026-02-09",
     "pay_date": "2026-02-12", "cash_amount": "0.26", "currency": "USD",
     "frequency": 4, "distribution_type": "recurring", "yield_pct": "0.100666"}
  ],
  "count": 4
}

frequency yıllık ödeme sayısıdır (4 = üç aylık); yield_pct ilan anındaki tek-ödeme verimidir.

Bir tarih aralığındaki tüm ABD temettüleri için — yaklaşan ödemeler takvimi, 100 sembole kadar bir izleme listesi — toplu listeyi kullanın; bkz. Temettüler.