Kripto
Piyasa geneli bir toplamdan 808 coin, USD cinsinden, 7/24: 24 saatlik kayan değişim, 24 saatlik hacim ve piyasa değeriyle son fiyat; ayrıca 2 saatlik ve günlük geçmiş.
Uç noktalar
| Uç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/quotes/crypto:{SYM} | quotes:crypto | Son fiyat (toplu: GET /v1/quotes?ids=…, ≤100 kimlik, piyasalar karışık olabilir) |
| GET/v1/instruments?market=crypto&limit=5000 | any key | cmc_id, slug, yenileme sıklığı ve geçmiş başlangıcıyla 808 coinlik katalog |
| GET/v1/candles/crypto:{SYM}?resolution=2h|1d&from=&to= | history | 2 saatlik anlık görüntüler (yalnızca kripto, çağrı başına ≤92 gün) veya günlük barlar |
| GET/v1/eod/crypto:{SYM}?from=&to= | history | Günlük barlar (UTC günleri) |
Yeni kapsam: quotes:crypto
quotes:crypto gerektirir — 15. kapsam. Mevcut anahtarlara otomatik eklenmez ve anahtar yenileme (rotate) eski kapsamları korur: yeni bir anahtar oluşturup quotes:crypto'yu işaretleyin (ya da Tümünü seç). Bu kapsam yoksa crypto: kimliği içeren tekli ya da toplu fiyat isteği, eksik kapsamı belirten bir 403 döner. Geçmiş (mumlar, EOD) her zamanki history kapsamını kullanır; katalog için herhangi bir anahtar yeterlidir.Kimlikler: crypto:{cmc_id}, kısayol olarak sembol
Bir coinin kimliği, sayısal kripto kimliğidir (cmc_id): crypto:1 Bitcoin, crypto:1027 Ethereum. Bu kimlik her coin için kaynakta bir kez atandığı için hiçbir zaman başka bir coini göstermeye başlamaz. Sembolü de kullanabilirsiniz — crypto:BTC çalışır, küçük harfli crypto:btc de — ancak yalnızca o sembolü tek bir coin kullanıyorsa; taşıdığımız 808 coinin 797'si bu durumda. Beş sembol paylaşılıyor (FRAX, GUSD, ONE, RIF, USDF): bunlar sizin adınıza tahmin etmek yerine, kastedebileceğiniz kimlikleri listeleyen 400 döner. Örneğin crypto:FRAX, seçebilmeniz için crypto:6952 (Legacy Frax Dollar) ve crypto:6953 (Frax, prev. FXS) yanıtını verir. Yanıtlar her zaman cmc_id biçimini döndürür; saklamanız gereken budur. Her katalog kaydı cmc_id, ticker ve slug taşır; bilinmeyen kimlik 404'tür.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/instruments?market=crypto&search=frax"{
"instruments": [
{"instrument_id": "crypto:6952", "symbol": "6952", "ticker": "FRAX",
"name": "Legacy Frax Dollar", "market": "crypto", "currency": "USD",
"cmc_id": 6952, "slug": "frax", "source": "aggregated",
"session": "24/7", "delay": "5m", "coverage_from": "2025-04-05"},
{"instrument_id": "crypto:6953", "symbol": "6953", "ticker": "FRAX",
"name": "Frax (prev. FXS)", "cmc_id": 6953, "slug": "frax-share", …},
{"instrument_id": "crypto:36039", "symbol": "36039", "ticker": "FRXUSD",
"name": "Frax USD", "cmc_id": 36039, "slug": "frax-usd", …}
],
"count": 3,
"market_sizes": {…, "crypto": 808, …}
}Fiyat alanları (kaynağa sadık)
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/quotes/crypto:1"{
"instrument_id": "crypto:1",
"symbol": "1",
"ticker": "BTC",
"market": "crypto",
"currency": "USD",
"last": "75844.98869736638",
"prev_close": null,
"change": "-1172.93959436797198419794522",
"change_pct": "-1.52294358",
"open": null, "high": null, "low": null,
"bid": null, "ask": null,
"volume": null,
"turnover": "38137498525.333206",
"limit_up": null, "limit_down": null,
"market_cap": "1523360780999.4902",
"as_of": "2026-09-16T10:57:00Z",
"data_delay_seconds": 0
}| Alan | Tür | Notlar |
|---|---|---|
| symbol / ticker | string | null | symbol, sayısal kripto kimliğidir (instrument_id içindeki sayının aynısı); ticker ise insan tarafından okunan semboldür, örn. BTC. ticker null ise coinin ifade edebildiğimiz bir sembolü yok demektir. |
| last | string | Son USD fiyatı. |
| change / change_pct | string | null | 24 saatlik kayan değişim, mutlak ve yüzde — 7/24 bir piyasada seans kapanışı yoktur. |
| prev_close / open / high / low | null | Her zaman null: toplamın son fiyatında seans açılış/yüksek/düşük ya da önceki kapanış yoktur ve bunları uydurmayız. bid/ask/volume da null'dır. |
| turnover | string | null | USD cinsinden 24 saatlik kayan işlem hacmi (coin adedi değil, para değeri). |
| market_cap | string | null | USD cinsinden piyasa değeri. Fiyat yanıtında yeni alan; diğer tüm piyasalarda null. |
| as_of | datetime | Toplamın kendi gözlem zamanı — bizim kaydettiğimiz zaman değil. Satırlar sıralamaya göre 60 sn, 3 dk veya 5 dk'da bir yenilenir (katalogdaki delay alanı); data_delay_seconds 0'dır. |
?currency=TRY veya EUR; last, change, turnover ve market_cap alanlarını güncel spot kurla çevirir (fx_rate / fx_as_of); change_pct asla çevrilmez.
Geçmiş: 2h ve 1d
resolution=2h (yalnızca kripto) 2 saatlik fiyat anlık görüntülerini döner: yalnızca close, t = UTC cinsinden görüntü dilimi; tek bir örnek bar olmadığı için open/high/low/turnover null'dır. Varsayılan pencere son 7 gündür; çağrı başına en fazla 92 gün.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/candles/crypto:BTC?resolution=2h&from=2026-09-14&to=2026-09-14"
# → {"instrument_id": "crypto:BTC", "resolution": "2h", "currency": "USD",
# "bars": [{"t": "2026-09-14T01:00:00Z", "open": null, "high": null, "low": null,
# "close": "…"}, … 12 bars …]}resolution=1d ve /v1/eod, o günün ~12 anlık görüntüsünden oluşturulan UTC günü başına bir bar döner: open = ilk, high/low = örneklerin en yükseği/en düşüğü (gerçek gün içi uç değerler değil), close = son (yaklaşık 23:00 UTC), turnover = kapanış örneğindeki 24 saatlik kayan USD hacmi. 2 saatlik görüntülerin başladığı 2026-01-29'dan önceki günlerde yalnızca close ve turnover bulunur. Bugünün barı hâlâ oluşmaktadır.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/eod/crypto:BTC?from=2026-09-13&to=2026-09-15"