Enstrümanlar ve piyasalar

PortGate'in sunduğu her enstrümanı keşfedin — Portfoy platformunun canlı enstrüman kayıt defterini izleyen, piyasa bazlı tam kataloglar.

Uç noktalar

Uç nokta	Kapsam	Açıklama
GET/v1/instruments	any key	Arama / listeleme; market=bist\|us\|fund\|fx\|cmdty\|index\|crypto, asset_type=, search=, limit= (tam kataloglar için 5000'e kadar)
GET/v1/instruments/{id}	any key	Tek bir enstrümanın referans kaydı
GET/v1/markets/{market}/status	any key	Saat tabanlı seans durumu (bist, us)
GET/v1/markets/{market}/movers	market scope	Canlı evrenden yükselenler / düşenler / en çok işlem görenler

Deneme Alanı'nda deneyin →

Tam kataloglar

Bir piyasanın tam listesini çekmek için yüksek bir limit değeri geçin (boyuta göre ölçülür, 100 satır / 1 birim). Yanıt, her şeye sahip olduğunuzu anlamanız için market_sizes içerir:

curl

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments?market=us&limit=5000"

response (abridged)

{
  "instruments": [
    {"instrument_id": "us:AAPL", "symbol": "AAPL", "name": "Apple Inc.",
     "market": "us", "currency": "USD", "asset_type": "CS",
     "exchange": "XNAS", "sector": "ELECTRONIC COMPUTERS", "sector_code": "3571",
     "logo_url": "https://api.theportfoy.com/portgate/v1/logos/us:AAPL"},
    ...
  ],
  "count": 1594,
  "markets_available": ["bist", "cmdty", "crypto", "fund", "fx", "index", "us"],
  "market_sizes": {"bist": 693, "cmdty": 39, "crypto": 808, "fund": 3753, "fx": 65, "index": 20, "us": 1594}
}

us ve fund katalogları çalışma zamanında Portfoy enstrüman kayıt defterinden yenilenir — yeni kotasyonlar bir API sürümü gerekmeden katalogda, hareket edenlerde ve WebSocket akışında görünür. BIST satırları ayrıca segment (yildiz/ana/alt/poip/izleme) ve price_mechanism taşır (auction, tek fiyatlı POİP/İZL isimleri için — çoğu sağlayıcının açığa çıkarmadığı bir bayrak).

sector / sector_code piyasaya göre farklı anlam taşır. BIST: Portföy sektörünün Türkçe adı ve slug'ı — /v1/sectors ile aynı 30 kod (ör. bankacilik); hisse hiçbir sektörde değilse null. ABD: SIC sektör açıklaması ve kodu. Kripto kayıtları bunun yerine cmc_id (sayısal kripto kimliği) ve slug taşır — kripto sayfasına bakın.

curl — a BIST record with its Portföy sector

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments/bist:THYAO"
# → { "instrument_id": "bist:THYAO", …, "sector": "Ulaşım & Lojistik", "sector_code": "ulasim_lojistik" }

asset_type ile filtreleme

İsteğe bağlı asset_type listeyi tek bir varlık türüne daraltır — satırın asset_type alanıyla büyük/küçük harf duyarsız tam eşleşme. bist'te ETF borsa yatırım fonlarını (BYF'ler, aşağıda) seçer; ABD satırları standart ABD varlık türü kodlarını kullanır (CS, ETF, ADRC, …). market ile birlikte kullanın:

curl

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments?market=bist&asset_type=ETF&limit=100"

BIST borsa yatırım fonları (BYF)

Borsa İstanbul borsa yatırım fonları (BYF) bist kataloğunun parçasıdır: bugün 35 satır (ZTM15F gibi işlem görmeyen kotasyonlar hariç), asset_type: "ETF" ve bist:ZPX30F, bist:GLDTRF, bist:USDTRF gibi kimliklerle. segment null'dır; beş ek null olabilen alan fonu tanımlar:

Alan	Tür	Notlar
founder	string \| null	BYF'nin kurucusu portföy yönetim şirketi, ör. "Ak Portföy"
category	string \| null	BYF'nin ne tuttuğu, ör. precious_metal_gold, money_market_equity_likit
underlying_index	string \| null	İzlenen endeks; BYF bir endeks izlemiyorsa null
is_participation	boolean \| null	Katılım (faizsiz finansa uygun) BYF'lerde true
fund_code	string \| null	BYF'nin 3 harfli TEFAS fon kodu, ör. bist:GLDTRF için FGA. Her enstrüman kaydında bulunur: hisselerde ve diğer piyasalarda null; TEFAS kodu olmayan BYF'lerde de null (ör. yeni işlem görmeye başlayanlar)

response row — bist:APGLDF

{
  "instrument_id": "bist:APGLDF",
  "symbol": "APGLDF",
  "name": "Ak Portföy Altın Katılım BYF",
  "market": "bist",
  "currency": "TRY",
  "segment": null,
  "price_mechanism": "continuous",
  "status": "normal",
  "asset_type": "ETF",
  "founder": "Ak Portföy",
  "category": "precious_metal_gold",
  "underlying_index": "Altın",
  "is_participation": true,
  "fund_code": "LTK"
}

BYF borsada işlem görür; fiyatlar, mumlar, WebSocket ve /v1/periodic için bist: kimliğini kullanın. Filtresiz bir bist listesi varsayılan limitle (50) BYF'lerin yalnız birkaçına ulaşır — hepsini şununla listeleyin: GET /v1/instruments?market=bist&asset_type=ETF&limit=100.

Sondaki F olmadan yazılan borsa kodu da çalışır: bist:GLDTR ve bist:GLDTR.F şuna çözülür: bist:GLDTRF; yanıtlar bu kanonik kimliği taşır. Takma ad fiyatlar (tekli ve toplu), mumlar, gün sonu, /v1/periodic (tekli ve toplu), /v1/instruments/{id}, /v1/stocks/{id}/indicators ve WebSocket aboneliğini kapsar; diğer yerlerde (instruments/{id}/parse, logolar, diğer /v1/stocks uçları, KAP filtreleri, funds/holders-of) kanonik kimliği kullanın.

curl — alias, answered with the canonical id

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments/bist:GLDTR"
# → { "instrument_id": "bist:GLDTRF", "symbol": "GLDTRF", …, "asset_type": "ETF", "fund_code": "FGA" }

BYF kimlikleri fiyat tarafında BIST hisse kimliklerinin çalıştığı her yerde çalışır: fiyatlar (tekli ve toplu), mumlar ve gün sonu geçmişi (5dk gün içi ve günlük), /v1/periodic (asset_type BYF) ve WebSocket fiyatları. Değerleme ve hedef fiyatlar bir BYF için 404 döner (hisse temelleri); finansal tablolar boş gelir; teknik göstergeler fiyat barlarından hesaplandığı için çalışır.

BYF'ler yatırım fonu değildir: fund: evreni hiçbirini içermez. BYF'lerin fon tarafındaki ikizleri (adı "… Borsa Yatırım Fonu" olan fon kayıtları, ör. fund:FGA) fon kataloğunda yer almaz — /v1/instruments/fund:FGA 404 döner; bist: kimliğini kullanın, fund_code onu FGA'ya bağlar. Fon kataloğunda adında "BYF Fon Sepeti" geçenler (ABE, AES, HOY, TFF, TGE) BYF'lere yatırım yapan yatırım fonlarıdır, BYF'nin kendisi değil; katalogda kalırlar.

Enstrümana özgü not: /v1/periodic/bist:GMSTRF asset_type olarak "BYF" yerine "STOCK" döner — üst kaynak bu satırı hisse olarak kayıtlar; değerler BYF'nindir.

Piyasa durumu

curl

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

response

{
  "market": "us", "status": "closed", "is_trading_day": false,
  "session_open": "09:30", "session_close": "16:00",
  "timezone": "America/New_York",
  "local_time": "2026-07-12T08:15:02-04:00",
  "next_open": "2026-07-13T09:30:00-04:00", "next_close": null,
  "holiday_calendar": "full NYSE holiday calendar (incl. Good Friday + weekend observations); early-close half days not yet covered"
}

BIST durumu sabit tarihli ulusal tatilleri kapsar; hareketli dini bayramlar açıkça kapsanmıyor olarak işaretlenir — yanıt her zaman kendi takvim kapsamını belirtir.