Skip to main content

Celestia gRPC API Overview

Updated on
Jul 04, 2025

Overview

The Celestia gRPC API offers fast, low-latency access to network data. Use it to query blockchain state, monitor on-chain activity, estimate gas, check transaction status, and detect network upgrades.

Access

You can access Celestia gRPC directly through your existing QuickNode Celestia endpoint—no additional add-ons are needed. The gRPC services are available on port 9090, a dedicated and secure channel for gRPC communication.

Endpoint and Token Configuration

When connecting to Celestia gRPC services, the port must be specified in the URL:

  • Endpoint: The name of your endpoint followed by .celestia-mainnet.quiknode.pro and the port number 9090 (e.g., https://docs-demo.celestia-mainnet.quiknode.pro:9090)
  • Token: The alphanumeric string that follows the endpoint name in the URL

For example, if your endpoint looks like this: https://docs-demo.celestia-mainnet.quiknode.pro/123456789/, then your authentication credentials would be:

  • Endpoint: https://docs-demo.celestia-mainnet.quiknode.pro:9090
  • Token: 123456789

Supported Services

Celestia gRPC API includes the following services:

Blob Service (celestia.blob.v1)


  • Params: Query blob module parameters

Signal Service (celestia.signal.v1)


  • VersionTally: Query voting power tally for a version
  • GetUpgrade: Query upgrade information if pending

Mint Service (celestia.mint.v1)


  • InflationRate: Get current inflation rate
  • AnnualProvisions: Get current annual provisions
  • GenesisTime: Get genesis time

MinFee Service (celestia.minfee.v1)


  • NetworkMinGasPrice: Query network-wide minimum gas price

Gas Estimation Service (celestia.core.v1.gas_estimation)


  • EstimateGasPrice: Estimate gas price based on recent blocks
  • EstimateGasPriceAndUsage: Estimate gas price and usage for transaction

Transaction Service (celestia.core.v1.tx)


  • TxStatus: Get transaction status (Committed/Pending/Evicted/Unknown)

Making Celestia gRPC Requests

To make requests to Celestia gRPC using different languages, check out the method-specific documentation for each service. Each method includes examples in:

We ❤️ Feedback!

If you have any feedback or questions about this documentation, let us know. We'd love to hear from you!

Share this doc