---
title: "Tài liệu API thông tin Leader Slot"
description: "Tổng quan và cách sử dụng API thông tin Leader Slot của Solana (getLeaderSlots API)"
canonical: "https://erpc.global/vi/doc/rpc/leader-slot-api/"
locale: "vi"
---

# Tài liệu API thông tin Leader Slot

## API thông tin Leader Slot (getLeaderSlots) là gì?

`getLeaderSlots` là phương thức Solana RPC mở rộng, trả về các bản ghi leader slot sắp tới kèm identity của validator, stake weight, metadata endpoint mạng, vị trí leader ước tính và số đo độ trễ tham chiếu. Nếu bạn có credit sử dụng ERPC (API token), bạn có thể gọi phương thức này theo cùng định dạng như một phương thức Solana RPC tiêu chuẩn.

API này cung cấp:

- Lịch trình validator leader bắt đầu từ slot được yêu cầu
- `stakeWeight` của từng validator leader
- Khu vực, thành phố, quốc gia, tọa độ, tổ chức ASN và múi giờ ước tính của leader
- Số đo ping tham chiếu từ các khu vực quan sát của ERPC qua `pingToLeaders`

## Endpoint và ví dụ Request Body

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

Chỉ định số slot bắt đầu trong `params`.

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

## Ví dụ (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]
  }'
~~~

## Ví dụ Response (JSON)

Response hiện tại đặt các bản ghi trong `result.data[]`. `result.total` cho biết số bản ghi được trả về. Mảng `data[]` bên dưới được rút gọn còn 3 trong 100 bản ghi của request này. Mục đầu tiên hiển thị `pingToLeaders` từ cả bảy khu vực quan sát của ERPC; các mục còn lại được cắt còn một khu vực cho dễ đọc.

~~~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"
          }
        ]
      }
    ]
  }
}
~~~

## Trường trong response

| Trường | Ý nghĩa |
| --- | --- |
| `result.success` | Request có thành công hay không. |
| `result.message` | Thông báo trạng thái dễ đọc. |
| `result.total` | Số bản ghi leader slot được trả về. Hiện tại API trả về 100 bản ghi cho mỗi request. |
| `result.data[]` | Các bản ghi leader slot theo thứ tự, bắt đầu từ slot được yêu cầu. |
| `identity` | Public key identity của validator leader. |
| `epoch` | Epoch Solana chứa slot này. |
| `slot` | Số slot. Giá trị này được trả về dưới dạng chuỗi, nên client không nên giả định đây là một số JSON. |
| `stakeWeight` | Stake được ủy thác cho validator leader. Stake càng cao thì nhìn chung validator càng xuất hiện thường xuyên trong lịch trình leader theo thời gian. |
| `leaderRegion` | Nhãn khu vực vận hành đã chuẩn hóa, dùng cho định tuyến và phân tích. Nhãn này có thể gộp các thành phố hoặc vị trí nhà cung cấp gần nhau. |
| `leaderCity`, `leaderCountry`, `leaderLat`, `leaderLon`, `leaderOrg`, `leaderTimezone` | Vị trí địa lý và tổ chức mạng ước tính của validator leader. |
| `pingToLeaders[]` | Độ trễ tham chiếu từ các khu vực quan sát của ERPC (`frankfurt`, `amsterdam`, `ny`, `london`, `tokyo`, `singapore`, `sydney`) tới leader, gồm region, city, ms, icmpReplied, fromIp, country, tọa độ, tổ chức ASN, mã bưu chính, timezone và measuredAt. |
| `pingToLeaders[].icmpReplied` | Validator có phản hồi phép đo hay không. Khi giá trị là `false`, `ms` chứa một giá trị sentinel được lưu sẵn chứ không phải độ trễ, và không nên được đọc như độ trễ; hãy coi `false` là không xác định, chứ không phải là ở xa hay không dùng được, vì một số validator không trả lời ICMP vẫn phục vụ TPU và QUIC bình thường, và việc lọc bỏ chúng có thể loại một leader khỏe mạnh khỏi đường gửi của bạn. Hãy kiểm tra `icmpReplied` trước khi tin `ms` là độ trễ — trường này quyết định con số đó có dùng được hay không, chứ không quyết định gửi tới validator nào. |
| `pingToLeaders[].measuredAt` | Thời điểm độ trễ được đo lần cuối, theo ISO-8601 UTC. Dùng giá trị này để đánh giá số đo còn mới đến mức nào. Mỗi khu vực quan sát đo độc lập, nên các mục trong cùng một mảng `pingToLeaders` có thể mang giá trị `measuredAt` khác nhau. `measuredAt` cũ hơn không có nghĩa là số đo bị hỏng: khi một lượt đo không hoàn tất, giá trị đã lưu được giữ nguyên thay vì bị ghi đè bằng một giá trị bịa ra, nên nó vẫn phản ánh một phép đo có thật trong quá khứ. |

## Hiển thị Leader Slot trực quan

Cùng một response có thể được xem như một dòng thời gian vận hành theo từng slot. Ví dụ này dùng Frankfurt làm điểm quan sát.

| Cửa sổ slot | Khu vực leader | Vị trí leader | Stake weight | Ping từ Frankfurt | Cách đọc vận hành |
| --- | --- | --- | --- | --- | --- |
| 436946064-436946066 | dublin | Crumlin, IE | 819,031.37 | 18.438 ms | Một leader giữ ba slot liên tiếp. Frankfurt phục vụ leader này ở 18.4 ms, nhưng London (11.0 ms) và Amsterdam (12.8 ms) gần hơn — trong cửa sổ này, tài nguyên ở London hoặc Amsterdam tốt hơn Frankfurt. |
| 436946068 | frankfurt | Frankfurt am Main, DE | 166,438.25 | 0.062 ms | Leader ở cùng khu vực đô thị. Tài nguyên Frankfurt được ưu tiên rõ rệt cho slot này. |

Góc nhìn này hữu ích vì Solana mang tính toàn cầu. Khác với HFT truyền thống, nơi mục tiêu chính thường là ở gần một matching engine, leader của Solana luân phiên giữa các validator trên khắp thế giới. Khu vực nhanh nhất thay đổi theo lịch trình leader.

## Website dữ liệu mạng Solana

[![Validators Solutions - dữ liệu mạng Solana](https://erpc.global/faq/ValidatorsSolutionsEN.jpg)](https://validators.solutions/)

Để xem công khai phân bố validator và mạng, hãy dùng [Validators Solutions](https://validators.solutions/). Dùng trang này để hiểu bức tranh rộng hơn của mạng Solana, sau đó dùng `getLeaderSlots` để lấy lịch trình cấp slot, stake weight, vị trí validator và dữ liệu độ trễ đo được cần cho định tuyến vận hành.

## Sử dụng token

API lấy 100 bản ghi leader slot bắt đầu từ slot được chỉ định. Mỗi request tiêu tốn 420 token.

Nếu bạn cần một mục cho mỗi validator trong toàn bộ epoch thay vì một mục cho mỗi slot, hãy dùng [Validators Information API](https://erpc.global/vi/doc/rpc/validators-information-api/), vốn được tính phí theo số validator mà nó trả về.

## Vì sao thông tin Leader Slot quan trọng

- Nếu leader ở xa về địa lý hoặc về đường mạng, việc gửi giao dịch trực tiếp trở nên kém hiệu quả.
- Stake weight giúp ước lượng mức độ thường xuyên mà một validator có khả năng xuất hiện trong lịch trình leader theo thời gian.
- Trong các lần chuyển leader trên toàn cầu, chiến lược chuyển đổi theo khu vực quan trọng hơn một con số độ trễ trung bình toàn cầu.
- Kết hợp lịch slot, stake weight, vị trí leader và dữ liệu ping đo được cho phép tối ưu định tuyến và vị trí đặt validator.

## Bối cảnh

Một epoch Solana gồm khoảng 432.000 slot. Việc liên tục thu thập lịch trình leader, metadata của validator, vị trí địa lý và số đo độ trễ đòi hỏi một pipeline dữ liệu chuyên dụng. ERPC duy trì dữ liệu này và cung cấp nó qua giao diện RPC dưới dạng bản đồ leader slot dùng được ngay.

## Trường hợp sử dụng chiến lược

- Tối ưu phát hiện: ưu tiên các cửa sổ leader ở gần và có độ trễ thấp.
- Triển khai đa khu vực: triển khai tại FRA, AMS, NY, TY, SGP và các khu vực chiến lược khác để giảm khoảng trống khi chuyển leader.
- Lập kế hoạch theo stake: dùng `stakeWeight` để hiểu những leader nào quan trọng thường xuyên hơn trong các khoảng thời gian dài hơn.
- Trực quan hóa và phân tích: theo dõi tỷ lệ leader, phân bố stake và phân bố độ trễ theo khu vực.

## Khả dụng

`getLeaderSlots` khả dụng cho tất cả người dùng ERPC. API token và credit sử dụng có thể được phát hành hoặc kiểm tra trên ERPC Web Dashboard.

- ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/vi)

## Tỷ lệ thành công giao dịch và SWQoS Endpoint

Để cải thiện thêm tỷ lệ thành công giao dịch và tốc độ thực thi, chúng tôi khuyến nghị sử dụng SWQoS Endpoint. SWQoS (Stake-weighted Quality of Service) ưu tiên các validator có kết nối stake. Leader phân bổ khoảng 80% băng thông cho lưu lượng ưu tiên và 20% cho lưu lượng không ưu tiên, trong đó làn ưu tiên có thông lượng cao gấp khoảng 5 lần. Việc lập lịch này diễn ra trước khi đánh giá Priority fee, nghĩa là vào được làn ưu tiên SWQoS là điều kiện tiên quyết cho hiệu năng độ trễ thấp thực sự.
