Skip to content

Start Building

API Documentation

Koios API is available across mainnet, preview and preprod Cardano Networks. You can find the API documentation with openAPI specs where you can also provide and test each and every endpoint below:

NetworkURLEndpointsRelease
Mainnethttps://koios.rest/api#mainnethttps://api.koios.rest/v1.4.0
Previewhttps://koios.rest/api#previewhttps://preview.koios.rest/v1.4.1
PreProdhttps://koios.rest/api#preprodhttps://preprod.koios.rest/v1.4.1

Koios Artifacts

If you'd like to dive in (to examine or to contribute) to the queries run, you're welcome to do so - all the SQL queries powering the gRest Query layer behind the scenes, API specs, tests, website assets, etc can be found on koios-artifacts github repository. You can find a high level repository map below.

Repository Map

bash
.
├── files            # SQL queries and cron jobs that facilitate additional cache to gRest instances
├── dashboards/      # Grafana dashboards used for monitoring Koios nodes
├── html/            # HTML Page(s) used for https://api.koios.rest website
├── images/          # Images (logos, Design diagram, etc) used for Koios
├── specs/           # Files used for creation of OpenAPI Specs with examples
├── tests/           # Test suites for Koios nodes
├── topology/        # Topology files of public Koios nodes
├── LICENSE          # License for use of artifacts within this repository
└── projects.json    # List of projects (in JSON format) that are using Koios

Project Management

Koios team operates gRest layer in a transparent manner and progress/millestones can be accessed at any time (accessible here).

Further discussions

You can connect and discuss with Koios teams on Telegram and Discord, or feel free to contribute to any of the repositories.

Released under the MIT License.