Metadata-Version: 2.5
Name: bitpin-sdk
Version: 0.1.0
Summary: Official Python SDK for the Bitpin exchange API (REST + WebSocket, sync + async)
Project-URL: Homepage, https://github.com/bitpin-dev/bitpin-sdk
Project-URL: Documentation, https://bitpin-dev.github.io/bitpin-sdk/
Project-URL: Source, https://github.com/bitpin-dev/bitpin-sdk/tree/main/python
Project-URL: Changelog, https://github.com/bitpin-dev/bitpin-sdk/blob/main/python/CHANGELOG.md
Project-URL: Issues, https://github.com/bitpin-dev/bitpin-sdk/issues
Author: Bitpin
License-Expression: MIT
License-File: LICENSE
Keywords: bitpin,ccxt,crypto,exchange,market-making,sdk,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: tomli>=2.0; python_version < '3.11'
Provides-Extra: ws
Requires-Dist: centrifuge-python<1,>=0.4; extra == 'ws'
Description-Content-Type: text/markdown

# bitpin-sdk

The official Python SDK for the [Bitpin](https://bitpin.ir) exchange API: sync `Bitpin` and async `AsyncBitpin`, ccxt method names and result structures, `Decimal` numbers, automatic token refresh, client-side rate limiting with overridable VIP limits, and WebSocket streams.

SDK رسمی پایتون برای API صرافی بیت‌پین. [مستندات فارسی](https://bitpin-dev.github.io/bitpin-sdk/fa/)

```bash
pip install bitpin-sdk          # REST
pip install "bitpin-sdk[ws]"    # + WebSocket
```

```python
from bitpin_sdk import Bitpin, Config

with Bitpin(Config.from_env()) as client:          # BITPIN_API_KEY, BITPIN_SECRET_KEY
    print(client.fetch_ticker("BTC/IRT")["last"])
    order = client.create_order("USDT/IRT", "limit", "buy", "10", "90000",
                                {"clientOrderId": "bot-1"})
    client.cancel_order_by_identifier("bot-1")
```

Bitpin has no sandbox: every call is real.

- [Documentation](https://bitpin-dev.github.io/bitpin-sdk/) (English and Persian)
- [Examples](https://github.com/bitpin-dev/bitpin-sdk/tree/main/examples/python)
- [llms.txt](https://github.com/bitpin-dev/bitpin-sdk/blob/main/llms.txt) for AI agents
- [Changelog](https://github.com/bitpin-dev/bitpin-sdk/blob/main/python/CHANGELOG.md)
- [Security](https://github.com/bitpin-dev/bitpin-sdk/blob/main/SECURITY.md)
