Ekubo API

The API that powers Ekubo's websites

Our API is in alpha and may undergo breaking changes without notice. Join the Discord to ask questions or get support.

https://prod-api.ekubo.org

This API is hosted at the above URL and contains data for all the chains that we are deployed to and index.

API Architecture

Our API functionality is based entirely on querying the Postgres schema kept up-to-date by the open source indexer repository (GitHub). You can replicate all of the API functionality by simply running your own instance of the Indexer and querying the resulting Postgres database. Much of the functionality is even conveniently contained in views and scheduled jobs allowing you to replicate all the functionalities of our API.

There are multiple layers of caching with varying TTL between the database and the client. If you have specific latency requirements or need to make a large number of requests per second, it's best to run your own indexer.

Rate limiting

We have a rate limiting web application firewall applied to the API. If you would like to make calls in excess of the limit, please reach out on Discord to find a solution. The rate limit is not fixed and we can change it as necessary to control costs or ensure fair access to all users. Generally we will not give out API keys where running the indexer is a reasonable option.

Endpoints

Our endpoints are documented via OpenAPI 3.1 at the /openapi.json endpoint. The URL is https://prod-api.ekubo.org/openapi.json

This means you can use it with any REST API explorer, e.g. the example swagger explorer or postman.