Ekubo API

The API that powers Ekubo's interface

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

Our API is found at the following endpoints, for Starknet mainnet and sepolia respectively:

  • https://mainnet-api.ekubo.org

  • https://sepolia-api.ekubo.org

API Architecture

Our API functionality is based entirely on querying the Postgres schema kept up-to-date by the open source indexer repository. You can replicate almost all of the API functionality by simply running your own instance of the indexer and querying the resulting Postgres database. Some of the functionality is even conveniently contained in materialized views.

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 discuss an arrangement.

Endpoints

Our endpoints are documented via OpenAPI 3.1 at the /openapi.json endpoint. For example, for mainnet: https://mainnet-api.ekubo.org/openapi.json

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

Last updated