Skip to content

depthy-io/depthy-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Method Description Free Tier
list_symbols() List tradable symbols Yes
get_depth(symbol) Order book depth & imbalance Yes (T1)
get_depth_recent(symbol) Depth snapshots over time Yes (T1)
get_walls(symbol) Large resting orders Yes (T1)
get_liquidation_clusters(symbol) Liquidation risk zones Yes (T1)
get_market(symbol) Price, volume, funding, OI Yes (T1)
get_oi_change(symbol) Open interest changes Yes
compare_symbols(symbols) Multi-symbol comparison Pro+
list_pm_markets() Polymarket markets Yes
get_pm_signals() Smart-money signals Yes
get_pm_top_wallets() Top wallets by profit Yes

Get an API Key

Sign up for a free key at depthy.io.

Links

License

MIT

About

Python SDK for Depthy — real-time crypto liquidity intelligence

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages