--- title: "Documentación de la API de información de slot del líder" description: "Descripción general y uso de la API de información de slot del líder de Solana (API getLeaderSlots)" canonical: "https://erpc.global/es/doc/rpc/leader-slot-api/" locale: "es" --- # Documentación de la API de información de slot del líder ## ¿Qué es la API de información de slot del líder (getLeaderSlots)? `getLeaderSlots` es un método extendido de Solana RPC que devuelve los registros de los próximos slots de líder con la identidad del validador, el peso de stake, los metadatos del endpoint de red, la ubicación estimada del líder y mediciones de latencia de referencia. Si tienes créditos de uso de ERPC (tokens de API), puedes llamarlo con el mismo formato que un método estándar de Solana RPC. Esta API proporciona: - El calendario de validadores líderes a partir del slot solicitado - `stakeWeight` de cada validador líder - Región, ciudad, país, coordenadas, organización ASN y zona horaria estimadas del líder - Mediciones de ping de referencia desde las regiones de observación de ERPC mediante `pingToLeaders` ## Ejemplo de endpoint y cuerpo de la solicitud ~~~text https://edge.erpc.global?api-key= ~~~ Especifica el número del slot inicial en `params`. ~~~json { "jsonrpc": "2.0", "id": 1, "method": "getLeaderSlots", "params": [436946064] } ~~~ ## Ejemplo (HTTP) ~~~bash curl 'https://edge.erpc.global?api-key=' \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc":"2.0", "id":1, "method":"getLeaderSlots", "params":[436946064] }' ~~~ ## Ejemplo de respuesta (JSON) La respuesta actual agrupa los registros en `result.data[]`. `result.total` indica cuántos registros se devolvieron. El array `data[]` de abajo se ha abreviado a tres de los 100 registros de esta solicitud. La primera entrada muestra `pingToLeaders` desde las siete regiones de observación de ERPC; en las demás entradas se deja una sola región para facilitar la lectura. ~~~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" } ] } ] } } ~~~ ## Campos de la respuesta | Campo | Significado | | --- | --- | | `result.success` | Si la solicitud tuvo éxito. | | `result.message` | Mensaje de estado legible para personas. | | `result.total` | Número de registros de slots de líder devueltos. Actualmente, la API devuelve 100 registros por solicitud. | | `result.data[]` | Registros de slots de líder ordenados a partir del slot solicitado. | | `identity` | Clave pública de identidad del validador líder. | | `epoch` | Época de Solana que contiene el slot. | | `slot` | Número de slot. Se devuelve como cadena, así que los clientes no deben suponer que es un número JSON. | | `stakeWeight` | Stake delegado al validador líder. Por lo general, cuanto mayor es el stake, más a menudo aparece el validador en los calendarios de líderes con el tiempo. | | `leaderRegion` | Etiqueta normalizada de la región operativa que se usa para el enrutamiento y el análisis. Puede agrupar ciudades cercanas o ubicaciones de proveedores. | | `leaderCity`, `leaderCountry`, `leaderLat`, `leaderLon`, `leaderOrg`, `leaderTimezone` | Geolocalización estimada y organización de red del validador líder. | | `pingToLeaders[]` | Latencia de referencia desde las regiones de observación de ERPC (`frankfurt`, `amsterdam`, `ny`, `london`, `tokyo`, `singapore`, `sydney`) hasta el líder, con región, ciudad, ms, icmpReplied, fromIp, país, coordenadas, organización ASN, código postal, zona horaria y measuredAt. | | `pingToLeaders[].icmpReplied` | Si el validador respondió a la medición. Cuando es `false`, `ms` contiene un valor centinela almacenado en lugar de una latencia y no debe interpretarse como tal. Trata `false` como desconocido, no como lejano ni inservible: algunos validadores que no responden a ICMP siguen atendiendo TPU y QUIC con normalidad, y filtrarlos puede dejar fuera de tu ruta de envío a un líder sano. Comprueba `icmpReplied` antes de tomar `ms` como una latencia: ese campo decide si la cifra es utilizable, no a qué validador enviar. | | `pingToLeaders[].measuredAt` | Cuándo se midió la latencia por última vez, en ISO-8601 UTC. Úsalo para juzgar hasta qué punto una lectura es actual. Cada región de observación mide de forma independiente, por lo que las entradas de un mismo array `pingToLeaders` pueden llevar valores de `measuredAt` distintos. Un `measuredAt` más antiguo no indica una lectura rota: cuando una ejecución de medición no llega a completarse, el valor almacenado se mantiene en lugar de sobrescribirse con uno inventado, de modo que sigue reflejando una medición real del pasado. | ## Visualización de los slots de líder La misma respuesta puede verse como una línea de tiempo operativa slot a slot. Este ejemplo usa Frankfurt como punto de observación. | Ventana de slots | Región del líder | Ubicación del líder | Peso de stake | Ping desde Frankfurt | Lectura operativa | | --- | --- | --- | --- | --- | --- | | 436946064-436946066 | dublin | Crumlin, IE | 819,031.37 | 18.438 ms | Un líder tiene tres slots consecutivos. Frankfurt lo atiende a 18.4 ms, pero London (11.0 ms) y Amsterdam (12.8 ms) están más cerca: para esta ventana, la capacidad en London o Amsterdam supera a la de Frankfurt. | | 436946068 | frankfurt | Frankfurt am Main, DE | 166,438.25 | 0.062 ms | Líder en la misma área metropolitana. Los recursos de Frankfurt tienen una clara ventaja en este slot. | Esta vista es útil porque Solana es global. A diferencia del HFT tradicional, donde el objetivo principal suele ser situarse cerca de un único matching engine, en Solana el papel de líder rota entre validadores de todo el mundo. La región más rápida cambia a medida que cambia el calendario de líderes. ## Sitio web de datos de la red de Solana [![Validators Solutions - datos de la red de Solana](https://erpc.global/faq/ValidatorsSolutionsEN.jpg)](https://validators.solutions/) Para una vista pública de la distribución de los validadores y de la red, usa [Validators Solutions](https://validators.solutions/). Úsalo para entender la red de Solana en su conjunto y, después, usa `getLeaderSlots` para obtener el calendario por slot, el peso de stake, la ubicación de los validadores y los datos de latencia medidos que necesita el enrutamiento operativo. ## Uso de tokens La API obtiene 100 registros de slots de líder a partir del slot especificado. Cada solicitud consume 420 tokens. Si necesitas una entrada por validador para toda la época en lugar de una entrada por slot, usa la [API de información de validadores](https://erpc.global/es/doc/rpc/validators-information-api/), que se factura según el número de validadores que devuelve. ## Por qué importa la información de slots de líder - Si el líder está lejos, geográficamente o por la ruta de red, la entrega directa de transacciones se vuelve ineficiente. - El peso de stake ayuda a estimar con qué frecuencia es probable que un validador aparezca en el calendario de líderes con el tiempo. - Durante las transiciones de líder por todo el mundo, las estrategias de cambio entre regiones importan más que una única latencia media global. - Combinar el calendario de slots, el peso de stake, la ubicación del líder y los datos de ping medidos permite optimizar el enrutamiento y la ubicación de los validadores. ## Contexto Una época de Solana consta de aproximadamente 432.000 slots. Recopilar de forma continua los calendarios de líderes, los metadatos de los validadores, la geolocalización y las mediciones de latencia requiere un pipeline de datos dedicado. ERPC mantiene estos datos y los ofrece a través de la interfaz RPC como un mapa de slots de líder listo para usar. ## Casos de uso estratégicos - Optimización de la detección: prioriza las ventanas de líderes cercanas y de baja latencia. - Despliegue en varias regiones: despliega en FRA, AMS, NY, TY, SGP y otras regiones estratégicas para reducir los huecos en las transiciones. - Planificación según el stake: usa `stakeWeight` para entender qué líderes importan con más frecuencia en ventanas más largas. - Visualización y análisis: supervisa la proporción de líderes, la distribución del stake y la distribución de la latencia por región. ## Disponibilidad `getLeaderSlots` está disponible para todos los usuarios de ERPC. Los tokens de API y los créditos de uso se pueden emitir o comprobar en el ERPC Web Dashboard. - ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/es) ## Tasa de éxito de las transacciones y endpoint SWQoS Para mejorar aún más la tasa de éxito y la velocidad de ejecución de las transacciones, recomendamos usar el endpoint SWQoS. SWQoS (Stake-weighted Quality of Service) da prioridad a los validadores con conexiones respaldadas por stake. Los líderes asignan aproximadamente el 80% del ancho de banda al tráfico prioritario y el 20% al no prioritario, y el carril prioritario ofrece aproximadamente 5x de rendimiento. Esta asignación se hace antes de evaluar las comisiones de prioridad, por lo que entrar en el carril prioritario de SWQoS es el requisito previo para lograr una baja latencia real.