Emtia ve kıymetli metaller
39 enstrüman: üç para biriminde spot altın ve gümüş, gram altın, Türk altın sikkeleri, baz metaller, enerji ve tarım vadelileri ve ABD Doları Endeksi — 15 dakika gecikmeli.
Uç noktalar
| Uç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/quotes/cmdty:{SYM} | quotes:cmdty | Tek fiyat (toplu: GET /v1/quotes?ids=…, ≤100 kimlik) |
| GET/v1/instruments?market=cmdty | any key | 39 enstrümanlık katalog — enstrüman başına para birimi, birim, kategori |
| GET/v1/candles/cmdty:{SYM}?resolution=5m|1d | history | Gün içi 5dk (yaklaşık son 7 gün) veya günlük barlar |
| GET/v1/eod/cmdty:{SYM}?from=&to= | history | Gün sonu kayıtları |
Fiyatlar orijinal işlem para birimindedir
Her enstrüman katalogda kendi currency, unit ve category değerlerini taşır — bunları okuyun, asla varlık türüne göre varsaymayın. Ons altın USD ile, gram altın TRY ile, mısır kile başına ABD senti ile fiyatlanır. Ham tedarikçi değerini dürüst bir para birimi etiketiyle sunarız — sessizce TRY'ye çevrilmiş bir rakam değil.
| Enstrümanlar | currency | unit | Nedir |
|---|---|---|---|
| GLD, SLV | USD | troy oz | Spot altın / gümüş (XAU, XAG) |
| GLDEUR, SLVEUR | EUR | troy oz | EUR cinsinden spot altın / gümüş |
| GLDTRY, SLVTRY | TRY | troy oz | TRY cinsinden spot altın / gümüş |
| XGLD, XSLV | TRY | gram | Gram altın / gram gümüş |
| PLD, PLT | USD | troy oz | Paladyum / platin spot |
| ATA, BESLI, CEYREK, YARIM, IKIBUCUK, GREMSE, ZIYNET, SCUM, SCUM_025, SRES, SRESK, SZIY, SZIY_025 | TRY | coin | Türk altın sikkeleri (adet başına) |
| BILEZIK, BILEZIK14, BILEZIK18 | TRY | gram | Bilezik, 22/14/18 ayar |
| ALUMINUM, LEAD, NICKEL, ZINC | USD | tonne | Baz metaller (LME'yi izleyen spot) |
| COPPER | USD | lb | Bakır spot |
| BRENT, NYMXP | USD | barrel | Brent / NYMEX ham petrol vadelileri |
| CORN, WHEATF1 | USX | bushel | Mısır / buğday vadelileri — ABD senti! |
| COTON, SUGAR | USX | lb | Pamuk / şeker vadelileri — ABD senti! |
| COCOAF1 | USD | metric ton | Kakao vadelisi |
| DXY | USD | index points | ABD Doları Endeksi — puan, fiyat değil |
currency değeri USX — ABD dolarının 1/100'ü. USD için 100'e bölün.Vadeliler vadelidir, spot değil
category değeri _future ile biten semboller (BRENT, NYMXP, CORN, WHEATF1, COTON, SUGAR, COCOAF1) en yakın vadeli kontratın gecikmeli fiyatlarıdır, spot fiyat değildir. Arayüzünüzde buna göre etiketleyin.Örnek: USD cinsinden Brent petrol
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/quotes/cmdty:BRENT"{
"instrument_id": "cmdty:BRENT",
"symbol": "BRENT",
"market": "cmdty",
"currency": "USD",
"last": "92.329500",
"prev_close": null,
"change": "0.628998",
"change_pct": "0.6859263",
"open": "91.474996", "high": "92.733000", "low": "91.320000",
"bid": "92.323000", "ask": "92.336000",
"volume": null, "turnover": null,
"as_of": "2026-08-21T10:53:28Z",
"data_delay_seconds": 900
}Seanslar, hafta sonları ve dürüst 404'ler
Borsada işlem gören vadeliler ve baz metaller hafta sonu işlem görmez: fiyat, doğru bir as_of ile son gözlemlenen değerlerde tutulur. Türk altın sikkeleri ve gram altın ise hafta içi saatlerin dışında da fiyat veren serbest piyasada işlem görür. Eski bir as_of taşıyan düz bir fiyat dürüstlüktür, takılı bir akış değil.
404 almak, o sembol için şu anda dürüstçe sunabileceğimiz bir değer olmadığı anlamına gelir. Ham fiyatla sunulan birkaç sembolde bu, bir dağıtımın hemen ardından, kaynak bir sonraki fiyatı geçene kadar da görülebilir. Sembol işlem görünce kendiliğinden düzelir — bu bir arıza değil, tasarlanmış dürüstlüktür. Boşluğu asla çevrilmiş veya bayat bir sayıyla doldurmayız.Geçmiş derinliği (günlük barlar 2020'ye kadar)
Günlük barlar tüm evrende 2020-01-01 tarihine kadar uzanır (satıcı arşivinden geri dolduruldu; yalnız işlem günleri); 5 dakikalık gün içi barlar yaklaşık 7 günlük kayan penceresini korur. Ham tedarikçi fiyatıyla sunulan vadeliler ve baz metaller geçmişte de ham değerlerle sunulur — asla eski TRY'ye çevrilmiş seri değil. Ham değeri olmayan günler atlanır; ham satırlarda hacim ve ciro yanlış olmaktansa null döner. Katalogdaki coverage_from alanı kapsam başlangıcını damgalar (cmdty için 2020-01-01).