CryptoQuant Python SDK

Unofficial Python SDK for the CryptoQuant API — unified access to on-chain and market data for Bitcoin, Ethereum, Stablecoins, ERC-20 tokens, XRP, TRX, and Altcoins.

Installation

pip install cryptoquant

Quick Start

from cryptoquant import CryptoQuant

client = CryptoQuant(api_key="your_api_key")

# Stablecoin exchange flows
data = client.get_stable_exch_inflow(
    token="usdc",
    exchange="all_exchange",
    window="day",
    limit=30,
)

Error Handling

from cryptoquant import (
    CryptoQuant,
    CryptoQuantHTTPError,
    CryptoQuantTimeoutError,
    CryptoQuantConnectionError,
)

try:
    data = client.get_stable_exch_inflow(token="usdc", exchange="binance", window="hour")
except CryptoQuantHTTPError as e:
    print(f"API error {e.status_code}: {e}")
except CryptoQuantTimeoutError:
    print("Request timed out")
except CryptoQuantConnectionError:
    print("Network error")

Supported Assets

Time Windows

CryptoQuant supports four time windows. Each endpoint supports a subset:

API Versions

The SDK transparently routes requests to the correct API version:

• Endpoints starting with v2/ → https://api.cryptoquant.com/v2/
• All other endpoints → https://api.cryptoquant.com/v1/

No configuration needed.

Advanced Usage

Custom timeout

client = CryptoQuant(api_key="...", default_timeout=60.0)

Incremental fetch with from_/to_

data = client.get_stable_exch_inflow(
    token="usdt_eth",
    exchange="binance",
    window="hour",
    from_="20240101T000000",
    to_="20240101T235959",
)

CSV output

csv_data = client.get_stable_exch_reserve(
    token="usdc",
    exchange="all_exchange",
    window="day",
    format_="csv",
)

Development

git clone https://github.com/LautaroParada/cryptoquant.git
cd cryptoquant
pip install -e ".[dev]"
pytest tests/ -v

License

MIT