ccxt_client is a pure Elixir client for interacting with 110+ cryptocurrency exchanges through a unified API.
It is generated from the CCXT exchange specifications and requires no Node.js at runtime — just Elixir.

{:ccxt_client, "~> 0.1"}

Overview

The library provides a consistent, type-safe interface for both public market data and authenticated trading
operations across a large number of exchanges.

All exchange modules are generated at compile time from specifications extracted from the
CCXT project’s 7+ years of accumulated exchange knowledge.

Usage examples

Public endpoints (works on all exchanges)

{:ok, ticker} = CCXT.Binance.fetch_ticker("BTC/USDT")
{:ok, book} = CCXT.Kraken.fetch_order_book("ETH/USD")

Authenticated endpoints (trading, balances, etc.)

creds = CCXT.Credentials.new(api_key: "...", secret: "...")
{:ok, balance} = CCXT.Bybit.fetch_balance(creds)

{:ok, order} =
  CCXT.OKX.create_order(
    "BTC/USDT",
    "limit",
    "buy",
    0.001,
    50_000.0,
    creds
  )

How it works

Instead of hand-writing and maintaining 110+ exchange modules, ccxt_client is generated using a small set of
reusable patterns:

1. Exchange specifications (endpoints, signing patterns, symbol formats, capabilities) are extracted from CCXT
2. Exchange modules are generated via macros at compile time
3. Requests are signed using 7 parameterized signing patterns that cover 95%+ of exchanges

This approach produces a large exchange surface area with minimal duplication and consistent behavior.

Features

• Unified API across 110+ exchanges
• Public endpoints: tickers, order books, trades, OHLCV
• Authenticated endpoints: balances, orders, trading
• Type-safe response structs
• WebSocket support with automatic reconnection
• Circuit breakers and rate limiting
• Bidirectional symbol normalization (BTC/USDT ↔ BTCUSDT)
• All exchanges compile and pass unit tests

Authenticated endpoints have been verified with real credentials on Deribit, Bybit, and a few other exchanges.

Where help is needed

While the signing implementations follow each exchange’s specification, many exchanges have not yet been tested
with real API credentials.

Community testing would be extremely valuable.

If you have an account on any exchange:

1. Try a public endpoint:

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

2. Try an authenticated endpoint using testnet or sandbox credentials

3. Report results (what worked / what didn’t) via GitHub issues

Every tested exchange improves the library for everyone.

Selective compilation

If you do not need all exchanges, you can limit which ones are compiled:

config :ccxt_client, exchanges: [:binance, :bybit, :okx]

Status

This is version v0.1.0 — early, but functional.
Feedback, issues, and pull requests are welcome.

Links

• Hex package: ccxt_client | Hex
• Documentation: ccxt_client v0.6.1 — Documentation
• Extraction tooling: https://github.com/ZenHive/ccxt_ex

https://github.com/ZenHive/ccxt_client