coinalyze

This is an unofficial Python client for coinalyze.net REST API.

Features

• Implementation of all endpoints.
• Uses httpx for making HTTP requests
• Uses pyrate-limiter for maintaining 40 API calls per minute.
• Uses httpx-retries for handling retries.
• Provides convenience functions to get results as pandas DataFrames

Installation

pip install coinalyze

Usage

1. Add your API key from coinalyze.net to your environment variables as COINALYZE_API_KEY.
2. Then use the client as shown in the example below.

See more examples in the coinalyze_client notebook.

import os
from coinalyze import CoinalyzeClient, HistoryEndpoint, Interval, response_to_df

client = CoinalyzeClient(api_key=os.getenv("COINALYZE_API_KEY"))

# Get exchange information as a list of dictionaries
client.get_exchanges()

# Get the supported future markets as a DataFrame
future_markets_df = response_to_df(client.get_future_markets())

# Get the current predicted funding rate
response = client.get_current_predicted_funding_rate("BTCUSDT_PERP.A")

# Get the open interest history as a DataFrame for a symbol
oi_df = client.get_history_df(
        endpoint=HistoryEndpoint.OI,
        symbols="BTCUSDT_PERP.A",
        interval=Interval.H4,
        start="2025-06-01",
        end="2025-06-20",
    )