Lider Slot Bilgileri API Dokümantasyonu

Lider Slot Bilgileri (getLeaderSlots) API Nedir?

getLeaderSlots, yaklaşan lider slot kayıtlarını validator kimliği, stake ağırlığı, ağ endpoint metadata'sı, tahmini lider konumu ve referans gecikme ölçümleriyle birlikte döndüren genişletilmiş bir Solana RPC metodudur. ERPC kullanım kredilerine (API token'larına) sahipseniz, bunu standart bir Solana RPC metoduyla aynı formatta çağırabilirsiniz.

Bu API şunları sağlar:

İstenen slottan başlayan lider validator programı
Her lider validator için stakeWeight
Tahmini lider bölgesi, şehir, ülke, koordinatlar, ASN organizasyonu ve saat dilimi
pingToLeaders aracılığıyla ERPC gözlem bölgelerinden referans ping ölçümleri

Endpoint ve İstek Gövdesi Örneği

endpoint

https://edge.erpc.global?api-key=<YOUR_API_KEY>

https://edge.erpc.global?api-key=<YOUR_API_KEY>

Başlangıç slot numarasını params içinde belirtin.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [436946064]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [436946064]
}

Örnek (HTTP)

bash

curl 'https://edge.erpc.global?api-key=<YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"getLeaderSlots",
    "params":[436946064]
  }'

curl 'https://edge.erpc.global?api-key=<YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"getLeaderSlots",
    "params":[436946064]
  }'

Örnek Yanıt (JSON)

Geçerli yanıt, kayıtları result.data[] içinde sarmalar. result.total, kaç kaydın döndürüldüğünü gösterir. Aşağıdaki data[] dizisi, bu isteğe ait 100 kaydın üçüne kısaltılmıştır. İlk kayıt, ERPC'nin yedi gözlem bölgesinin tümünden pingToLeaders verisini gösterir; kalan kayıtlar okunabilirlik için tek bir bölgeye indirilmiştir.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true,
    "message": "Leader schedule records retrieved successfully",
    "total": 100,
    "data": [
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946064",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          },
          {
            "city": "Newark",
            "region": "ny",
            "ms": 74.981,
            "icmpReplied": true,
            "fromIp": "64.130.37.222",
            "country": "US",
            "lat": 40.73566,
            "lon": -74.17237,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "07102",
            "timezone": "America/New_York",
            "measuredAt": "2026-08-03T06:22:21.000Z"
          },
          {
            "city": "London",
            "region": "london",
            "ms": 10.978,
            "icmpReplied": true,
            "fromIp": "67.209.52.250",
            "country": "GB",
            "lat": 51.50853,
            "lon": -0.12574,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "WC2N",
            "timezone": "Europe/London",
            "measuredAt": "2026-08-03T06:23:06.000Z"
          },
          {
            "city": "Singapore",
            "region": "singapore",
            "ms": 166.379,
            "icmpReplied": true,
            "fromIp": "202.8.11.52",
            "country": "SG",
            "lat": 1.2959,
            "lon": 103.7907,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "139963",
            "timezone": "Asia/Singapore",
            "measuredAt": "2026-08-03T06:24:52.000Z"
          },
          {
            "city": "Amsterdam",
            "region": "amsterdam",
            "ms": 12.827,
            "icmpReplied": true,
            "fromIp": "84.32.103.245",
            "country": "NL",
            "lat": 52.37403,
            "lon": 4.88969,
            "org": "AS59642 UAB Cherry Servers",
            "postal": "1012",
            "timezone": "Europe/Amsterdam",
            "measuredAt": "2026-08-03T06:21:33.000Z"
          },
          {
            "city": "Ebara",
            "region": "tokyo",
            "ms": 212.499,
            "icmpReplied": true,
            "fromIp": "198.13.133.88",
            "country": "JP",
            "lat": 35.617,
            "lon": 139.7486,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "140-0002",
            "timezone": "Asia/Tokyo",
            "measuredAt": "2026-08-03T06:24:01.000Z"
          },
          {
            "city": "Sydney",
            "region": "sydney",
            "ms": 274.379,
            "icmpReplied": true,
            "fromIp": "82.26.116.36",
            "country": "AU",
            "lat": -33.86785,
            "lon": 151.20732,
            "org": "AS29802 HIVELOCITY, Inc.",
            "postal": "1001",
            "timezone": "Australia/Sydney",
            "measuredAt": "2026-08-03T06:25:50.000Z"
          }
        ]
      },
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946065",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          }
        ]
      },
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946066",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          }
        ]
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true,
    "message": "Leader schedule records retrieved successfully",
    "total": 100,
    "data": [
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946064",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          },
          {
            "city": "Newark",
            "region": "ny",
            "ms": 74.981,
            "icmpReplied": true,
            "fromIp": "64.130.37.222",
            "country": "US",
            "lat": 40.73566,
            "lon": -74.17237,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "07102",
            "timezone": "America/New_York",
            "measuredAt": "2026-08-03T06:22:21.000Z"
          },
          {
            "city": "London",
            "region": "london",
            "ms": 10.978,
            "icmpReplied": true,
            "fromIp": "67.209.52.250",
            "country": "GB",
            "lat": 51.50853,
            "lon": -0.12574,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "WC2N",
            "timezone": "Europe/London",
            "measuredAt": "2026-08-03T06:23:06.000Z"
          },
          {
            "city": "Singapore",
            "region": "singapore",
            "ms": 166.379,
            "icmpReplied": true,
            "fromIp": "202.8.11.52",
            "country": "SG",
            "lat": 1.2959,
            "lon": 103.7907,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "139963",
            "timezone": "Asia/Singapore",
            "measuredAt": "2026-08-03T06:24:52.000Z"
          },
          {
            "city": "Amsterdam",
            "region": "amsterdam",
            "ms": 12.827,
            "icmpReplied": true,
            "fromIp": "84.32.103.245",
            "country": "NL",
            "lat": 52.37403,
            "lon": 4.88969,
            "org": "AS59642 UAB Cherry Servers",
            "postal": "1012",
            "timezone": "Europe/Amsterdam",
            "measuredAt": "2026-08-03T06:21:33.000Z"
          },
          {
            "city": "Ebara",
            "region": "tokyo",
            "ms": 212.499,
            "icmpReplied": true,
            "fromIp": "198.13.133.88",
            "country": "JP",
            "lat": 35.617,
            "lon": 139.7486,
            "org": "AS20326 TeraSwitch Networks Inc.",
            "postal": "140-0002",
            "timezone": "Asia/Tokyo",
            "measuredAt": "2026-08-03T06:24:01.000Z"
          },
          {
            "city": "Sydney",
            "region": "sydney",
            "ms": 274.379,
            "icmpReplied": true,
            "fromIp": "82.26.116.36",
            "country": "AU",
            "lat": -33.86785,
            "lon": 151.20732,
            "org": "AS29802 HIVELOCITY, Inc.",
            "postal": "1001",
            "timezone": "Australia/Sydney",
            "measuredAt": "2026-08-03T06:25:50.000Z"
          }
        ]
      },
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946065",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          }
        ]
      },
      {
        "identity": "BXAxLMMMUNYfC1z166VjWHR3WjTmqzLxB837o5ghmRtH",
        "epoch": 1011,
        "slot": "436946066",
        "stakeWeight": 819031.365477103,
        "ipAddress": "202.8.10.164",
        "gossipPort": 8000,
        "tpuPort": null,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "4.1.2",
        "featureSet": "3345198602",
        "leaderRegion": "dublin",
        "leaderCity": "Crumlin",
        "leaderCountry": "IE",
        "leaderLat": 53.32154,
        "leaderLon": -6.31439,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Dublin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 18.438,
            "icmpReplied": true,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin",
            "measuredAt": "2026-08-03T06:20:48.000Z"
          }
        ]
      }
    ]
  }
}

Yanıt Alanları

Alan	Anlamı
`result.success`	İsteğin başarılı olup olmadığı.
`result.message`	İnsan tarafından okunabilir durum mesajı.
`result.total`	Döndürülen lider slot kayıtlarının sayısı. API şu anda istek başına 100 kayıt döndürür.
`result.data[]`	İstenen slottan başlayan sıralı lider slot kayıtları.
`identity`	Lider validator kimlik açık anahtarı.
`epoch`	Slotu içeren Solana epoch'u.
`slot`	Slot numarası. Bir dize (string) olarak döndürülür, bu nedenle istemciler bunu bir JSON sayısı olarak varsaymamalıdır.
`stakeWeight`	Lider validator'a delege edilen stake. Daha yüksek stake genellikle validator'ın zaman içinde lider programlarında daha sık görünmesi anlamına gelir.
`leaderRegion`	Yönlendirme ve analiz için kullanılan normalleştirilmiş operasyonel bölge etiketi. Yakındaki şehirleri veya sağlayıcı konumlarını gruplayabilir.
`leaderCity`, `leaderCountry`, `leaderLat`, `leaderLon`, `leaderOrg`, `leaderTimezone`	Lider validator için tahmini coğrafi konum ve ağ organizasyonu.
`pingToLeaders[]`	ERPC gözlem bölgelerinden (`frankfurt`, `amsterdam`, `ny`, `london`, `tokyo`, `singapore`, `sydney`) lidere referans gecikme; bölge, şehir, ms, icmpReplied, fromIp, ülke, koordinatlar, ASN organizasyonu, posta kodu, saat dilimi ve measuredAt dahil.
`pingToLeaders[].icmpReplied`	Validator'ın ICMP ölçümünü yanıtlayıp yanıtlamadığı. `false` olduğunda `ms`, bir gecikme değil saklanan bir sentinel değer taşır ve gecikme olarak okunmamalıdır. `false` değerini uzak ya da kullanılamaz değil, bilinmiyor olarak değerlendirin: ICMP'ye yanıt vermeyen bazı validator'lar TPU ve QUIC'i sorunsuz sunmayı sürdürür ve bunları elemek, sağlıklı bir lideri gönderim yolunuzdan çıkarabilir. `ms` değerini gecikme olarak kullanmadan önce `icmpReplied` alanını kontrol edin: bu alan sayının kullanılabilir olup olmadığına karar verir, hangi validator'a göndereceğinize değil.
`pingToLeaders[].measuredAt`	Gecikmenin en son ne zaman ölçüldüğü, ISO-8601 UTC olarak. Bir okumanın ne kadar güncel olduğunu değerlendirmek için kullanın. Her gözlem bölgesi bağımsız ölçtüğü için aynı `pingToLeaders` dizisindeki kayıtlar farklı `measuredAt` değerleri taşıyabilir. Daha eski bir `measuredAt`, bozuk bir okuma anlamına gelmez: bir ölçüm turu tamamlanamadığında saklanan değer uydurma bir değerle üzerine yazılmaz, olduğu gibi bırakılır; dolayısıyla geçmişte gerçekten yapılmış bir ölçümü yansıtmayı sürdürür.

Lider Slotlarını Görselleştirme

Aynı yanıt, slot-slot operasyonel bir zaman çizelgesi olarak görüntülenebilir. Bu örnek, gözlem noktası olarak Frankfurt'u kullanır.

Slot penceresi	Lider bölgesi	Lider konumu	Stake ağırlığı	Frankfurt'tan ping	Operasyonel yorum
436946064-436946066	dublin	Crumlin, IE	819,031.37	18.438 ms	Bir lider art arda üç slotu üstlenir. Frankfurt bunu 18.4 ms ile sunar, ancak London (11.0 ms) ve Amsterdam (12.8 ms) daha yakındır — bu pencere için London veya Amsterdam kapasitesi Frankfurt'tan daha iyidir.
436946068	frankfurt	Frankfurt am Main, DE	166,438.25	0.062 ms	Aynı metropol lideri. Bu slot için Frankfurt kaynakları güçlü bir şekilde tercih edilir.

Bu görünüm yararlıdır çünkü Solana globaldir. Ana hedefin genellikle tek bir eşleştirme motoruna yakın konumlanmak olduğu geleneksel HFT'nin aksine, Solana liderleri dünyanın dört bir yanındaki validator'lar arasında dönüşümlü olarak değişir. En hızlı bölge, lider programı değiştikçe değişir.

Solana Ağ Verileri Web Sitesi

Validators Solutions - Solana ağ verileri

Validator ve ağ dağılımının kamuya açık bir görünümü için Validators Solutions kullanın. Daha geniş Solana ağını anlamak için bunu kullanın, ardından operasyonel yönlendirme için gereken slot seviyesinde program, stake ağırlığı, validator konumu ve ölçülen gecikme verileri için getLeaderSlots kullanın.

Token Kullanımı

API, belirtilen slottan başlayarak 100 lider slot kaydı alır. Her istek 420 token tüketir.

Slot başına bir kayıt yerine tüm epoch için validator başına bir kayıt gerekiyorsa, döndürdüğü validator sayısı üzerinden ücretlendirilen Validator Bilgileri API metodunu kullanın.

Lider Slot Bilgileri Neden Önemlidir?

Lider coğrafi olarak veya ağ yolu açısından uzaksa, doğrudan işlem teslimatı verimsiz hale gelir.
Stake ağırlığı, bir validator'ın zaman içinde lider programında ne sıklıkta görünebileceğini tahmin etmeye yardımcı olur.
Küresel lider geçişleri sırasında, bölgesel geçiş stratejileri tek bir küresel ortalama gecikmeden daha önemlidir.
Slot programı, stake ağırlığı, lider konumu ve ölçülen ping verilerinin birleştirilmesi, optimize edilmiş yönlendirme ve validator yerleşimi sağlar.

Arka Plan

Tek bir Solana epoch'u yaklaşık 432.000 slottan oluşur. Lider programlarını, validator metadata'sını, coğrafi konumu ve gecikme ölçümlerini sürekli olarak toplamak, özel bir veri hattı gerektirir. ERPC bu veriyi tutar ve RPC arayüzü üzerinden hemen kullanılabilir bir lider slot haritası olarak sunar.

Stratejik Kullanım Senaryoları

Tespit optimizasyonu: yakındaki, düşük gecikmeli lider pencerelerine öncelik verin.
Çok bölgeli dağıtım: geçiş boşluklarını azaltmak için FRA, AMS, NY, TY, SGP ve diğer stratejik bölgelerde dağıtım yapın.
Stake'e duyarlı planlama: daha uzun pencereler boyunca hangi liderlerin daha sık önemli olduğunu anlamak için stakeWeight kullanın.
Görselleştirme ve analiz: lider oranlarını, stake dağılımını ve bölgeye göre gecikme dağılımını izleyin.

Kullanılabilirlik

getLeaderSlots tüm ERPC kullanıcıları için kullanılabilir. API token'ları ve kullanım kredileri, ERPC Web Dashboard üzerinde verilebilir veya doğrulanabilir.

ERPC Web Dashboard: ERPC Web Dashboard

İşlem Başarı Oranı ve SWQoS Endpoint

İşlem başarı oranını ve yürütme hızını daha da artırmak için SWQoS Endpoint kullanmanızı öneririz. SWQoS (Stake-weighted Quality of Service), stake bağlantıları olan validator'lara öncelik verir. Liderler, bant genişliğinin yaklaşık %80'ini öncelikli trafiğe ve %20'sini öncelikli olmayan trafiğe ayırır; öncelikli şerit yaklaşık 5 kat verim sunar. Bu zamanlama, Priority-fee değerlendirmesinden önce gerçekleşir; bu da SWQoS öncelikli şeridine girmenin, gerçek düşük gecikmeli performansın ön koşulu olduğu anlamına gelir.