Introduction
Celenium API is a powerful tool to access all blockchain data that is processed and indexed by our proprietary indexer. With Celenium API you can retrieve all historical data, off-chain data, blobs and statistics through our REST API.
Celenium API indexer are open source, which allows you to not depend on third-party services. You can clone, build and run them independently, giving you full control over all components.
If you have any questions or feature requests, please feel free to contact us. We appreciate your feedback!
Discord: https://discord.gg/3k83Przqk8
Twitter: https://twitter.com/celenium_io
EMail: celenium@pklabs.me
And don't forget to star our projects on GitHub if you like it 😊
Get Started
We offer a choice of two subscription types:
Free API plan with free anonymous access;
Paid API plans with authorization, increased rate limits, off-chain data, access to statistics and extended support.
Free API
Free-tier Celenium API is the best way to get started and explore available Celestia data and API functionality. It requires no authorization and is free for everyone, for both commercial and non-commercial use.
:::caution [Attribution Required]
If you use the free Celenium API, you must mention this on your website or app by stating "Powered by Celenium API", "Built with Celenium API" or "Data provided by Celenium API" with a direct link to celenium.io.
:::
You access the Celestia networks below with the following URLs:
Mainnet:
https://api-mainnet.celenium.io/v1/
Mocha:
https://api-mocha.celenium.io/v1/
Arabica:
https://api-arabica.celenium.io/v1/
Sending Requests
To send a request to Celenium API you need literally nothing. Just take the base URL of the particular network (for example, Celestia Mainnet: https://api-mainnet.celenium.io
) and append the path of the particular endpoint (for example, chain's head: /v1/head
), that's pretty much it:
curl https://api-mainnet.celenium.io/v1/head
Rate Limits
Please, refer to https://api-plans.celenium.io to check relevant rate limits.
If you exceed the limit, the API will respond with HTTP 429
status code.
Paid API plans
Paid subscriptions are for professional use, for those seeking advanced features, performance and reliability. You can check all available subscription options here.
You access the Celestia networks below with the following URLs:
Mainnet:
https://api-mainnet.celenium.io/v1/
Testnets: let us know if you need increased rate limits or specific access for testnets
Authorization
To authorize your requests you have to select the required tariff on our site. Then you receive api key to authorize. Api key should be passed via request header apikey
. For example:
curl --location 'https://api-mainnet.celenium.io/v1/head' --header 'apikey: <YOUR-API-KEY-HERE>'