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=, platform=, product_type=, tradable=, 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 |
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 -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/instruments?market=us&limit=5000"{
"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ı 47 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 -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 -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; fon satırları gibi platform: "byf", product_type: "etf" ve tradable: true da taşırlar (aşağıda Fon platformu filtreleri):
| 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) |
{
"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",
"platform": "byf",
"product_type": "etf",
"tefas_status": null,
"befas_status": null,
"tradable": true
}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 -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.
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.
Fon platformu filtreleri
Fon satırları ve BIST BYF satırları fonun nereden alındığını ve bugün işleme açık olup olmadığını söyler. Herhangi bir market ile filtreleyin (birden çok platform değeri virgülle, ör. tefas,befas):
| Alan | Tür | Notlar |
|---|---|---|
| platform | string | null | tefas | befas | byf. tefas ve befas sağlayıcının etiketleridir ve örtüşmez (her BEFAS fonu emeklilik fonudur); byf = BIST borsa yatırım fonları, bist: kimlikleriyle listelenir. Referans kaydı olmayan fonlarda (bu filtrelerden düşerler) ve diğer tüm piyasalarda null. |
| product_type | string | null | mutual_fund | pension_fund | venture_capital_fund | real_estate_fund | etf (BIST BYF'leri). Bilinmeyen değer 422'dir. |
| tefas_status / befas_status | string | null | TEFAS / BEFAS işlem durumu: open | closed; fon o platformda değilse null. |
| tradable | boolean | null | true = kendi platformunda işleme açık (TEFAS/BEFAS durumu open; BIST BYF'leri her zaman true); false = listede ama kapalı. |
tefas etiketi TEFAS'ta işlem görmeyen fonları da kapsar (serbest fonların çoğu, girişim sermayesi ve gayrimenkul fonları). Bugün TEFAS'tan alınabilenleri listelemek için tradable=true ekleyin:
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/instruments?market=fund&platform=tefas&tradable=true&limit=5000"{
"instrument_id": "fund:AAL",
"symbol": "AAL",
"name": "ATA PORTFÖY PARA PİYASASI (TL) FONU",
"market": "fund",
"fund_type": "Para Piyasası Fonu",
"platform": "tefas",
"product_type": "mutual_fund",
"tefas_status": "open",
"befas_status": null,
"tradable": true,
...
}curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/instruments?market=fund&platform=befas&limit=5000"market=fund&platform=byf 400 döner — platform=byf parametresini tek başına ya da market=bist&platform=byf kullanın. Fon sıralaması (/v1/funds/ranking) platform=tefas|befas ve tradable alır — bkz. TR fonları.Piyasa durumu
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/markets/us/status"{
"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.
