Nuevos usuarios de RPC: 35% de descuento el primer mesVer oferta

Endpoints RPC y gRPC de Sui Mainnet

Una Layer 1 centrada en objetos para activos, DeFi, gaming y aplicaciones de consumo rápidas y escalables.

Conecta Sui Mainnet mediante la infraestructura gRPC y RPC lista para producción de OnFinality. Consulta checkpoints, transacciones, objetos y saldos con Sui Full Node gRPC, ejecuta o simula transacciones y recibe actividad en tiempo real.

Sui ha deprecado Full Node JSON-RPC en favor de gRPC y GraphQL. OnFinality ofrece acceso gRPC para migrar aplicaciones existentes o crear wallets, exchanges, indexadores, exploradores, juegos y backends.

Regístrate en el plan gratuito para desbloquear hasta 40 req/s y obtener analítica de uso y rendimiento de la API. Empezar

Límite del endpoint público: 5 req/sec

Conecta con Sui Mainnet

Mainnet Testnet

grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

grpcurl -v \ -d '{ "sequence_number": "299599072", "read_mask": { "paths": ["transactions"] } }' \ sui.api.onfinality.io:443 \ sui.rpc.v2.LedgerService/GetCheckpoint

Host gRPC de Sui

sui.api.onfinality.io:443

sui.api.onfinality.io:443

Endpoint JSON-RPC

https://sui.api.onfinality.io/public

https://sui.api.onfinality.io/public

Pasa a Growth Plan

Alto rendimiento
Analítica RPC potente
Hasta 500 rps
Sin límite diario de respuestas
Soporte prioritario
Servidores descentralizados

Empezar

Detalles RPC y gRPC de Sui Mainnet

Elemento

Valor

Red

Sui Mainnet

Token nativo

SUI

Protocolo principal

Sui gRPC v2

Protocolo legacy

Sui JSON-RPC

Transporte gRPC

HTTP/2 + TLS

Transporte JSON-RPC

HTTPS

Streaming gRPC

Compatible

Host gRPC

sui.api.onfinality.io:443

Endpoint JSON-RPC

https://sui.api.onfinality.io/public

Regiones

N. Virginia / Hong Kong

Disponibilidad de 30 días

99,99 % · Ver detalles

Conectar con Sui Mainnet

Usa la API gRPC de Sui Full Node para acceder de forma tipada a checkpoints, transacciones, objetos y saldos. El endpoint público es útil para las primeras pruebas; añade una API key para el tráfico autenticado de la aplicación.

Endpoint gRPC público

grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

Endpoint gRPC autenticado

grpcurl -v \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

Comprobar conectividad gRPC

grpcurl sui.api.onfinality.io:443 sui.rpc.v2.LedgerService/GetServiceInfo

Sui ha dejado obsoleto Full Node JSON-RPC en favor de gRPC y GraphQL. Usa gRPC para nuevas integraciones y migra las aplicaciones JSON-RPC existentes como parte de tu ruta de actualización.

API gRPC del Full Node de Sui

Sui gRPC expone servicios tipados para leer el estado del ledger, consultar objetos y paquetes Move, ejecutar transacciones y consumir datos blockchain en vivo desde un Sui Full Node.

LedgerService

GetServiceInfo
GetObject
BatchGetObjects
GetTransaction
BatchGetTransactions
GetCheckpoint
GetEpoch
ListCheckpoints
ListTransactions
ListEvents

StateService

ListDynamicFields
ListOwnedObjects
GetCoinInfo
GetBalance
ListBalances

SubscriptionService

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

TransactionExecutionService

ExecuteTransaction
SimulateTransaction

MovePackageService

GetPackage
GetDatatype
GetFunction
ListPackageVersions

NameService

LookupName
ReverseLookupName

SignatureVerificationService

VerifySignature

Streaming gRPC de Sui en tiempo real

Usa SubscriptionService streams para recibir checkpoints, transacciones y eventos a medida que se producen. El streaming evita sondear repetidamente endpoints HTTP en aplicaciones que necesitan actividad de Sui en vivo.

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

Estos streams tipados proporcionan los equivalentes gRPC de los flujos legacy sui_subscribeEvent y sui_subscribeTransaction flujos de trabajo.

Usar máscaras de campos con Sui gRPC

Las máscaras de campos permiten que los clientes soliciten solo los campos de respuesta que necesitan. Esto mantiene las respuestas centradas y ayuda a controlar el tamaño del payload al consultar checkpoints, transacciones y objetos detallados.

{
  "sequence_number": "299599072",
  "read_mask": {
    "paths": ["transactions"]
  }
}

Sui JSON-RPC — acceso legacy

Las aplicaciones existentes pueden seguir usando Sui JSON-RPC durante la migración. El endpoint legacy sigue siendo útil por compatibilidad, pero las nuevas integraciones de Sui deberían preferir gRPC o GraphQL mientras la red abandona Full Node JSON-RPC.

curl -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"sui_getTotalTransactionBlocks"
  }' \
  'https://sui.api.onfinality.io/public'

Migrar de Sui JSON-RPC a gRPC

Sustituye las llamadas a métodos legacy por métodos de servicios gRPC tipados al actualizar clientes, indexadores, wallets y servicios backend.

Sui JSON-RPC	Sui gRPC
`sui_getObject`	`LedgerService.GetObject`
`sui_getTransactionBlock`	`LedgerService.GetTransaction`
`suix_queryTransactionBlocks`	`LedgerService.ListTransactions`
`suix_queryEvents`	`LedgerService.ListEvents`
`sui_subscribeEvent`	`SubscriptionService.SubscribeEvents`
`sui_subscribeTransaction`	`SubscriptionService.SubscribeTransactions`
`sui_executeTransactionBlock`	`TransactionExecutionService.ExecuteTransaction`
`sui_dryRunTransactionBlock`	`TransactionExecutionService.SimulateTransaction`

Ver la guía de migración de Sui JSON-RPC →

Construye en Sui con gRPC

Wallets y exchanges

Consulta saldos, objetos, transacciones y actividad en vivo para wallets de Sui, sistemas de custodia y flujos de exchanges.

Indexadores y exploradores

Combina consultas del ledger, máscaras de campos y suscripciones para crear datasets de Sui, exploradores, búsquedas y pipelines de analítica.

Aplicaciones DeFi

Lee el estado de objetos y saldos, simula transacciones, ejecuta transacciones firmadas y transmite la actividad del protocolo para productos DeFi.

Juegos y aplicaciones de consumo

Usa el modelo centrado en objetos de Sui y streams en tiempo real para activos de juegos, funciones sociales, coleccionables digitales y experiencias de consumo.

Pipelines de datos backend

Usa respuestas gRPC tipadas y servicios de streaming para alimentar sistemas operativos, monitorización, informes y productos de datos sin ejecutar un Full Node.

Endpoints de Sui Mainnet y Testnet

Entorno	Mainnet	Testnet
Red	Sui Mainnet	Sui Testnet
gRPC	Compatible	Compatible
JSON-RPC	Legacy	Legacy
Entorno	Producción	Desarrollo / QA
Más adecuado para	Aplicaciones en producción	Pruebas y staging