Saltar al contenido principal

¿Qué son los límites de frecuencia?

Los límites de frecuencia controlan cuántas solicitudes puedes realizar por segundo. Cuando los superes, recibirás una respuesta HTTP 429. Para saber qué hacer cuando recibas un error 429 u otro fallo transitorio, consulta Reintentos y manejo de errores más adelante.

Límites de frecuencia estándar

Tu plan tiene dos grupos de límites de frecuencia estándar: uno para las solicitudes RPC y otro para las solicitudes de la API DAS. Estos son los límites de frecuencia base de cada plan de Helius:
PlanLímite de frecuencia de RPCDAS y API mejoradas
Gratis10 solicitudes/s2 solicitudes/s
Desarrollador50 solicitudes/s10 solicitudes/s
Negocios200 solicitudes/s50 solicitudes/s
Profesional500 solicitudes/s100 solicitudes/s
EmpresarialPersonalizadoPersonalizado

Aumenta los límites de frecuencia

Los equipos con planes Professional pueden comprar 100 RPS adicionales por $100 USD al mes. Si necesitas límites de frecuencia personalizados antes de un lanzamiento, contacta a nuestro equipo de ventas. Si tienes el nivel Desarrollador o Negocios, mejora tu plan para aumentar tus límites de frecuencia.

Límites de frecuencia especiales

Algunos endpoints y productos especializados de Helius tienen límites de frecuencia especiales debido a sus requisitos de procesamiento.

Envío de transacciones

EndpointGratisDesarrolladorNegociosProfesional
Sender50/s50/s50/s50/s
sendTransaction1/s5/s50/s100/s
sendBundle——5/s5/s
simulateBundle10/s50/s200/s500/s
Las solicitudes /fast sin clave de Sender están limitadas a 1 solicitud por segundo por IP de salida y por región. Quienes realizan llamadas detrás del mismo NAT comparten este límite. Las solicitudes 429 rechazadas cuentan para el límite; /ping no cuenta. Agrega la clave de API de tu proyecto de Helius existente para obtener el límite de 50 solicitudes por segundo, por clave y por región.
Si tienes un plan Professional y necesitas aumentar tus límites de frecuencia de sendTransaction, contacta a nuestro equipo de ventas. Los usuarios del plan Professional también pueden solicitar aumentos de los límites de frecuencia y acuerdos personalizados de propinas para Sender a fin de admitir aplicaciones de trading con mayor rendimiento.

Llamadas RPC complejas

EndpointGratisDeveloperBusinessProfessional
getProgramAccounts5/s25/s50/s75/s

Datos históricos

Al realizar solicitudes por lotes para métodos de datos históricos, se aplican los siguientes límites:
MétodoTamaño máximo del lote
getTransaction100 elementos por solicitud
getTransactionsForAddressNo se permiten solicitudes por lotes
getTransfersByAddressNo se permiten solicitudes por lotes
Todos los demás métodos históricos10 elementos por solicitud
Si superas los límites de los lotes, recibirás una respuesta de error. Para getTransactionsForAddress y getTransfersByAddress, debes consultar cada dirección en una solicitud independiente.

LaserStream

RecursoGratisDeveloperBusinessProfessional
Redes—DevnetDevnet, MainnetDevnet, Mainnet
Máximo de claves públicas—10M10M10M
Conexiones activas——10100

Wallet API

La Wallet API sigue los mismos límites de frecuencia que DAS y las API mejoradas. Todos los endpoints comparten estos límites:
EndpointGratisDeveloperBusinessProfessional
Todos los endpoints de Wallet API2/s10/s50/s100/s
Esto incluye endpoints para búsquedas de identidad, saldos, historial, transferencias y fuentes de fondos. Obtén más información en nuestra documentación de Wallet API.

Flujos analizados

RecursoGratisDeveloperBusinessProfessional
Conexiones simultáneas5105050
Suscripciones por conexión25252525
Las conexiones se cuentan por proyecto entre todas sus claves de API. Un proyecto que alcanza su límite de conexiones recibe un HTTP 429. Consulta los límites de Parsed Streams para conocer los límites por filtro y por mensaje.

WebSocket de LaserStream

RecursoGratisDeveloperBusinessProfessional
Conexiones simultáneas51502501,000
Suscripciones por conexión1,0001,0001,0001,000
Tipos de WebSocketEstándarEstándar, mejoradoEstándar, mejoradoEstándar, mejorado

Webhooks

RecursoGratisDeveloperBusinessProfessional
Máximo de webhooks5505050
Direcciones por webhook100k100k100k100k

Compresión ZK

ServicioGratisDeveloperBusinessProfessional
API de Photon2/s10/s50/s100/s
getValidityProof1/s5/s10/s20/s

Reintentos y gestión de errores

Cuando tu aplicación reciba una respuesta 429 Too Many Requests, 503 Service Unavailable o una respuesta 5xx transitoria, espera un momento y vuelve a intentarlo; no lo hagas de inmediato. Los reintentos inmediatos acumulan solicitudes y hacen que la recuperación del límite de frecuencia sea más lenta, no más rápida.

Estrategia recomendada

  • Espera aproximadamente 1 segundo antes del primer reintento.
  • Duplica la espera cada vez que vuelvas a intentarlo, hasta un máximo de 30 segundos.
  • Agrega una pequeña variación aleatoria de ±25% a cada espera para que varias aplicaciones no vuelvan a intentarlo al mismo tiempo.
  • Desiste después de 5 intentos y devuelve el error al código que realizó la llamada.

Qué errores debes volver a intentar

Ejemplo

Estructura de la respuesta de error

Todas las API de Helius devuelven un cuerpo JSON estructurado cuando ocurre un error. Los endpoints JSON-RPC (Solana RPC, DAS, Sender, Priority Fee y ZK Compression) devuelven el contenedor estándar de JSON-RPC 2.0:
Los endpoints REST (Wallet API y Admin API) devuelven:
Consulta Códigos de error comunes para ver la lista completa de códigos de error y el significado de cada uno.