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ç noktaKapsamAçıklama
GET/v1/instrumentsany keyArama / 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 keyTek bir enstrümanın referans kaydı
GET/v1/markets/{market}/statusany keySaat tabanlı seans durumu (bist, us)
GET/v1/markets/{market}/moversmarket scopeCanlı 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ı 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 — 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; fon satırları gibi platform: "byf", product_type: "etf" ve tradable: true da taşırlar (aşağıda Fon platformu filtreleri):

AlanTürNotlar
founderstring | nullBYF'nin kurucusu portföy yönetim şirketi, ör. "Ak Portföy"
categorystring | nullBYF'nin ne tuttuğu, ör. precious_metal_gold, money_market_equity_likit
underlying_indexstring | nullİzlenen endeks; BYF bir endeks izlemiyorsa null
is_participationboolean | nullKatılım (faizsiz finansa uygun) BYF'lerde true
fund_codestring | nullBYF'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",
  "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 — 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.

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):

AlanTürNotlar
platformstring | nulltefas | 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_typestring | nullmutual_fund | pension_fund | venture_capital_fund | real_estate_fund | etf (BIST BYF'leri). Bilinmeyen değer 422'dir.
tefas_status / befas_statusstring | nullTEFAS / BEFAS işlem durumu: open | closed; fon o platformda değilse null.
tradableboolean | nulltrue = 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 — funds open on TEFAS today
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments?market=fund&platform=tefas&tradable=true&limit=5000"
response row (abridged)
{
  "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 — pension funds (BEFAS)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments?market=fund&platform=befas&limit=5000"
BYF'ler fon kataloğunda değil, bist: kimlikleriyle listelenir. 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
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.