v0.2.0 released — WebSocket adapters, telemetry, and a breaking change

Quick update on ccxt_client. v0.2.0 is out with some significant improvements and one breaking change.

Breaking: Trading modules removed

CCXT.Trading.* modules (Greeks, Funding, Risk, Volatility, Options, etc.) have been extracted to a separate library. If you were using any of those modules, they’re no longer in ccxt_client.

ccxt_client is now a focused exchange-access library — HTTP, WebSocket, signing, symbol normalization, and types only. No changes to any exchange API functionality.

{:ccxt_client, "~> 0.2"}

What’s new

WebSocket Adapter

A managed GenServer that handles reconnection, subscription restoration, and auth state automatically:

{:ok, adapter} =
  CCXT.Bybit.WS.Adapter.start_link(
    url_path: [:public, :spot],
    handler: fn msg -> process_message(msg) end
  )

{:ok, sub} = CCXT.Bybit.WS.watch_ticker_subscription("BTC/USDT")
:ok = CCXT.Bybit.WS.Adapter.subscribe(adapter, sub)

The adapter:

• Reconnects with exponential backoff
• Re-subscribes to all active channels after reconnect
• Handles auth re-authentication with state tracking
  (:unauthenticated → :authenticated → :expired)

The low-level CCXT.WS.Client is still available for short-lived connections where you manage lifecycle yourself.

Telemetry

Centralized event contract with attach/2 and detach/1 support:

CCXT.Telemetry.attach(:my_handler, fn event, measurements, metadata ->
  Logger.info("#{metadata.exchange} #{event}: #{measurements.duration}ms")
end)

Six events covering:

• HTTP requests
• WebSocket messages
• Rate limiting
• Circuit breaker state changes

Market Precision Metadata

Extract precision info from any exchange’s markets:

{:ok, markets} = CCXT.Binance.fetch_markets()
precisions = CCXT.MarketPrecision.from_markets(markets, :binance)
# => %{"BTC/USDT" => %CCXT.MarketPrecision{price: 2, amount: 5, ...}}

Handles all three CCXT precision modes:

• Tick size
• Decimals
• Significant digits

Includes a TradingView-compatible price format helper.

Other improvements

• Updated rate limit costs across all 10 Tier 1 exchange specs from upstream CCXT
• Generator improvements: decoupled coercer/parser pipeline, version-override path prefix handling
• Deribit bug fixes:
  • fetch_trades/1 arity
  • WS balance channel
  • WS ticker interval suffix

Still looking for testers

The ask from the original post still stands — if you have an account on any exchange, trying even a single endpoint and reporting what happens is enormously helpful:

CCXT.YourExchange.fetch_ticker("BTC/USDT")

Open an issue with what worked and what didn’t.

v0.4.0 — Compile-time 93% faster, named params, self-describing APIs

Hey all, sharing a progress update on ccxt_client. v0.4.0 is going up on Hex today.

Compile-time: 35s → 2.5s

The biggest win this release. Exchange modules used to inline the full pipeline per endpoint — Binance alone took 28 seconds. We replaced that with a shared runtime dispatcher (Dispatch.call/5) where generated functions are thin wrappers looking up pre-computed @endpoint_configs. Binance now compiles in ~1 second. .beam sizes dropped 85%.

# What the generator produces now (per endpoint):
def fetch_ticker(symbol, opts \\ []) do
  Dispatch.call(__MODULE__, :fetch_ticker, [symbol], opts, @endpoint_configs)
end

Named params everywhere

Positional arg0/arg1 replaced with actual parameter names across all 52 specs. Function signatures now read naturally:

# Before
CCXT.Binance.fetch_ohlcv(symbol, arg0, arg1, opts)

# After
CCXT.Binance.fetch_ohlcv(symbol, timeframe, since, opts)

Timeframe translation

Unified timeframes ("1h", "1d") are automatically translated to exchange-native formats ("60", "D") for both REST and WebSocket. No more checking what Phemex calls a daily candle.

# Just use standard timeframes — translation happens automatically
{:ok, candles} = CCXT.Phemex.fetch_ohlcv("BTC/USDT", "1d", credentials: creds)

Symbol format v2

Symbol normalization got significantly richer — forward_aliases, prefix handling, colon separators, and split_no_separator for exchanges that don’t use delimiters. Coverage went from basic delimiter mapping to handling most exchange quirks.

Self-describing APIs (Descripex)

Exchange modules now expose machine-readable metadata about their capabilities:

CCXT.Binance.__ccxt_spec__().endpoints
# Returns structured endpoint definitions with param types, defaults, etc.

This is groundwork for agent-consumable APIs — other tools (including AI agents) can discover what an exchange supports programmatically.

Other highlights

• CCXT v4.5.42 sync — added Lighter (DEX), 4 new parse methods (TWAP, ADL rank)
• 993 response transformers — column-oriented OHLCV, variable-length order book levels, bid/ask array coercion
• CCXT.Health — quick exchange health checks (ping/2, latency/2, status/1)
• Order sanity checks — validation on order responses
• Sync verification script — scripts/verify_sync.sh validates nothing breaks across spec refreshes

Installation

{:ccxt_client, "~> 0.4"}

Still need your help testing

The library covers 107 exchanges, but most authenticated endpoints still need real-world validation. If you trade on any exchange and can spare 10 minutes with testnet credentials, open an issue with what works and what doesn’t. Every exchange tested helps everyone.

GitHub · Hex · Docs