Welcome!

Introduction

Welcome to the official documentation for Koinju, your comprehensive source for institutional-grade cryptocurrency market data. We deliver real-time and historical data from leading crypto exchanges—including trades, OHLCV candles, and sophisticated derivatives analytics such as recomputed option Greeks (delta, gamma, theta, vega). Whether you’re building trading algorithms, risk models, or analytics dashboards, our infrastructure ensures low-latency, high-fidelity data at scale.

Our Data Ecosystem

We specialize in:

  • Market Data: Tick-level trades, order books, and aggregated OHLCV candles.

  • Derivatives Intelligence: Greeks, implied volatility and futures funding rates.

  • Multi-Exchange Coverage: Unified schemas across 17+ exchanges, normalized for consistency.

Two Interfaces, One Unified Platform

To serve diverse needs, we offer two complementary access methods:

  1. REST API Ideal for simple integrations, rapid prototyping, and lightweight data consumption. Features include:

    • OpenAPI documentation and spec file available here

    • Curated endpoints for common queries (e.g., "ETH-USD trades from Binance").

    • Authentication via API keys.

    • Pagination and basic time-range filtering.

  2. Direct SQL Access For complex analytics and bulk data retrieval, connect directly to our ClickHouse database:

    • Run SQL queries for advanced filtering, aggregation, and joins.

    • Optimized for large-scale historical scans (e.g., "All BTC options with gamma > 0.5 in Q1 2024" or "All BTC-USD trades from Coinbase since 2014).

    • Avoid retrieval of large dataset by computing the relevant metrics directly in the clickhouse instance.

Who Uses Our Data?

  • Quantitative Developers: Backtest strategies with nanosecond-precision trades.

  • Data Scientists: Build ML models on normalized historical candles.

  • Traders: Monitor real-time option Greeks across exchanges.

  • Analysts: Generate institutional reports via SQL-powered business intelligence tools.

What’s in This Documentation?

  • Getting Started: API keys, SQL connection strings, and quickstart guides.

  • REST API Reference: Endpoint specifications, examples, and error codes.

  • SQL Guide: Schema details, optimization tips, and sample queries.

  • Use Cases: Tutorials for trading signals, volatility analysis, and more.

Last updated