Skip to main content

A Lightweight Python Package for Low-Latency and Cross-Exchange Trading.

Project description

dcex - dex & cex trading library

Important: No default broker tags are set. You may manually specify a broker tag within function arguments if needed.

Forked from krex, a simplified version of the ccxt Python library.

Originally created and maintained by the same contributor, this fork continues active development, building upon the original foundation with enhanced design, unified DEX + CEX support, and fixes for previously unresolved issues.

A high-performance and lightweight Python library for interacting with cryptocurrency exchanges. dcex offers full synchronous and asynchronous support across major exchanges, designed for speed, modularity, and ease of use.

Python License PyPI

📦 Installation

pip install dcex

or use uv to manage the project:

uv add dcex

🚀 Quick Start

Synchronous Usage

import dcex
import os

# Initialize client for any supported exchange
client = dcex.binance(
    api_key="your_api_key",
    api_secret="your_api_secret"
)

# Get market data
klines = client.get_klines(product_symbol="BTC-USDT-SWAP", interval="1h")
print(klines)

Asynchronous Usage

import asyncio
import dcex.async_support as dcex
import os

async def main():
    # Initialize async client
    client = await dcex.binance(
        api_key="your_api_key",
        api_secret="your_api_secret"
    )

    try:
        # Get market data
        klines = await client.get_klines(product_symbol="BTC-USDT-SWAP", interval="1h")
        print(klines)

    finally:
        await client.close()

if __name__ == "__main__":
    asyncio.run(main())

📚 Supported Exchanges

Exchange Sync Support Async Support
Binance
Bybit Testing Testing
OKX
BitMart Testing Testing
Gate.io Testing Testing
Hyperliquid Testing Testing
BitMEX Testing Testing
BingX Developing Developing
KuCoin Developing Developing
Zoomex Developing Developing

🔍 Key Features

  • 📘 Product Table Manager for unifying trading instruments in different exchanges
  • 🔁 Sync & Async API clients with identical interfaces
  • ⚡ Optimized for low-latency, high-frequency trading

What is Product Table Manager(ptm)?

Ptm is a utility that standardizes and unifies trading instrument metadata across different exchanges, making cross-exchange strategy development easier.

It is a table that contains the following columns:

Column Description
exchange The exchange name
product_symbol The symbol we use to identify the product, it will be the same in different exchanges. For example, BTC-USDT-SWAP is the same product in Binance and Bybit, which named BTCUSDT in Binance and BTC-USDT-SWAP in OKX.
exchange_symbol The symbol that the exchange will actually used
product_type The type we will use, e.g. spot, inverse, swap, futures
exchange_type The type the exchange will actually used, e.g. linear, INVERSE, perp... different exchanges have different types, pretty annoying...
base_symbol The base symbol, e.g. BTC
quote_symbol The quote symbol, e.g. USDT
price_precision The price precision, e.g. 0.000001
size_precision The size precision, e.g. 0.000001
min_size The minimum size, e.g. 0.000001
min_notional The minimum notional, e.g. 0.000001
multiplier The multiplier of the product, such symbol like 1000BONKUSDT in Bybit will need to be multiplied by 1000 to get the actual size, if you are trading across spot and swap, you will need this
size_per_contract The size per contract. Sometimes 1 contract is not the same as 1 unit in exchanges like OKX.

How to use Product Table Manager?

In most cases, we have handled the case, but if you have any specific use cases, you can use the ptm to get the information you want.

import dcex

bn = dcex.binance()

product_symbol = bn.ptm.get_product_symbol(
    exchange="binance",
    exchange_symbol="BTCUSDT",
    product_type="swap",
)

print(product_symbol)

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the MIT License.

🆘 Support

📜 Disclaimer

Cryptocurrency trading involves significant risk. This library is provided as-is without any warranty. Users are responsible for their own trading decisions and risk management.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dcex-0.4.1.tar.gz (61.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dcex-0.4.1-py3-none-any.whl (78.3 kB view details)

Uploaded Python 3

File details

Details for the file dcex-0.4.1.tar.gz.

File metadata

  • Download URL: dcex-0.4.1.tar.gz
  • Upload date:
  • Size: 61.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for dcex-0.4.1.tar.gz
Algorithm Hash digest
SHA256 17e3a29784bbfb9564693191e5dcc0c2215dbf1e161978b99404d065dbbd1429
MD5 2fd5b80530a46992e1491ebd60e6f79c
BLAKE2b-256 ad86db4136b722d260ab600a95231f79aa5a7099839725de9d4dd5d3be4a4f11

See more details on using hashes here.

File details

Details for the file dcex-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: dcex-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 78.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for dcex-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cf59ea981fb8d7d2804f1c59e7a6cf17eafbaf706d703261a8bd8605b214664a
MD5 27e4c8d68897150aa608b307481e7210
BLAKE2b-256 80648c5aea351af9d56e058c13c9733014a44292b168c5d3a0b7cb20d701dc8e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page