ctg-exchange 0.1.2

Python SDK for the CTG.EXCHANGE exchange API (REST + WebSocket)

CTG.EXCHANGE Python SDK

Python client for the CTG.EXCHANGE exchange API — a thin, typed wrapper over the public REST + WebSocket interface.

Install

pip install ctg-exchange

Requires Python 3.9+.

Quick start

Public market data — no key needed

from ctg-exchange import Client

with Client() as client:
    for sym in client.get_symbols():
        print(sym.symbol, sym.tick_size)

    book = client.get_order_book("CTGUSDT")
    print(book.bids[0].price, book.asks[0].price)

Private account & trading

API keys are created in the CTG.EXCHANGE web app (Account → API keys). Pass them to the client — never hard-code them; read them from the environment.

import os
from ctg-exchange import Client

with Client(api_key=os.environ["CTG_EXCHANGE_API_KEY"],
            api_secret=os.environ["CTG_EXCHANGE_API_SECRET"]) as client:
    for balance in client.get_balances():
        print(balance.asset, balance.available)

    result = client.place_order(
        "CTGUSDT", side="buy", type="limit", price="100.00", qty="1",
    )
    print(result.order.id, result.order.status)

WebSocket streams

import asyncio
from ctg-exchange import MarketDataStream

async def main():
    async with MarketDataStream(channels=["trades@CTGUSDT"]) as stream:
        async for msg in stream:
            print(msg.channel, msg.type, msg.data)

asyncio.run(main())

The private UserStream takes api_key / api_secret and authenticates in-band with a signed first frame. Subscribe to any of orders, trades, balances:

import asyncio, os
from ctg-exchange import UserStream

async def main():
    async with UserStream(
        api_key=os.environ["CTG_EXCHANGE_API_KEY"],
        api_secret=os.environ["CTG_EXCHANGE_API_SECRET"],
        channels=["orders", "balances"],
    ) as stream:
        async for msg in stream:
            print(msg.channel, msg.type, msg.data)

asyncio.run(main())

Both streams auto-reconnect and re-subscribe on a dropped socket.

The decimal contract

Every monetary value — price, qty, volume, fee amounts — is a decimal.Decimal, never a float. The API sends and receives these as JSON strings; this SDK parses them losslessly. When placing orders, price / qty accept a Decimal, str or int.

Errors

Non-2xx responses raise a typed exception — BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, RateLimitError, ServerError — all subclasses of APIError. Each carries status_code and the API's request_id; RateLimitError adds retry_after. Pass max_retries= to Client to auto-retry 429s.

What this SDK does not do

Withdrawals are not part of the CTG.EXCHANGE API and not in this SDK — they require a wallet signature and happen only in the web app.

Development

pip install -e ".[dev]"
pytest            # offline tests run with no credentials
ruff check .

Integration tests run only when CTG_EXCHANGE_API_KEY / CTG_EXCHANGE_API_SECRET are set, and are read-only — they never place orders.

Links

• Docs: https://docs.ctg.exchange
• API reference: https://docs.ctg.exchange/api/reference/
• Security policy: SECURITY.md

License

Apache-2.0