Depthy Python SDK

Python client for the Depthy API — real-time crypto order book depth, liquidity walls, liquidation clusters, and Polymarket signals.

Install

pip install depthy-python

Quick Start

from depthy import DepthyClient

client = DepthyClient(api_key="dk_live_your_key_here")

# List available symbols
symbols = client.list_symbols()

# Order book depth
depth = client.get_depth("BTC")

# Liquidity walls
walls = client.get_walls("ETH", min_size_usd=200000)

# Liquidation clusters
clusters = client.get_liquidation_clusters("SOL")

# Market overview
market = client.get_market("BTC")

# Open interest changes
oi = client.get_oi_change("BTC")

# Compare multiple symbols (Pro key required)
comparison = client.compare_symbols(["BTC", "ETH", "SOL"])

Async Usage

from depthy import AsyncDepthyClient

async with AsyncDepthyClient(api_key="dk_live_your_key_here") as client:
    depth = await client.get_depth("BTC")
    walls = await client.get_walls("ETH")

Polymarket

# Active prediction markets
markets = client.list_pm_markets(market_type="crypto_15m")

# Smart-money signals
signals = client.get_pm_signals(limit=10)

# Top wallets by profit
wallets = client.get_pm_top_wallets(limit=5)

Error Handling

from depthy import DepthyClient, AuthError, RateLimitError, NotFoundError

client = DepthyClient(api_key="dk_live_...")

try:
    depth = client.get_depth("BTC")
except AuthError:
    print("Check your API key")
except RateLimitError:
    print("Slow down — free tier: 30 req/min")
except NotFoundError:
    print("Symbol not found")

API Methods

Get an API Key

Sign up for a free key at depthy.io.

Links

• MCP Server — For Claude Desktop, Cursor, etc.
• API Docs — Full endpoint reference

License

MIT