Metadata-Version: 2.4
Name: cryptocom-tools-exchange
Version: 2.0.0
Summary: Exchange/market data tools for Crypto.com Developer Platform
Author-email: "Crypto.com" <support@crypto.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/crypto-com/agent-client-py
Project-URL: Documentation, https://github.com/crypto-com/agent-client-py
Project-URL: Repository, https://github.com/crypto-com/agent-client-py
Project-URL: Bug Tracker, https://github.com/crypto-com/agent-client-py/issues
Keywords: blockchain,crypto,exchange,market-data,ticker,trading
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptocom-tools-core>=2.0.0
Requires-Dist: crypto-com-developer-platform-client>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: basedpyright>=1.13.0; extra == "dev"
Dynamic: license-file

# cryptocom-tools-exchange

Exchange/market data tools for the Crypto.com Developer Platform.

## Installation

```bash
pip install cryptocom-tools-exchange
```

## Features

- **GetAllTickersTool**: Get all available exchange tickers
- **GetTickersTool**: Get ticker information for a specific trading instrument

All tools are read-only and require no signer/wallet.

## Usage

```python
import os
from cryptocom_tools_exchange import GetAllTickersTool, GetTickersTool

# Set your CDP API key
os.environ["CRYPTOCOM_DEVELOPER_PLATFORM_API_KEY"] = "your-api-key"

# Get all tickers
all_tickers_tool = GetAllTickersTool()
result = all_tickers_tool.invoke({})
print(result)

# Get a specific ticker
ticker_tool = GetTickersTool()
result = ticker_tool.invoke({"symbol": "CRO_USDT"})
print(result)
```

## How it works

These tools call the Crypto.com Developer Platform Exchange API via the
`crypto_com_developer_platform_client.Exchange` client. Authentication uses the
`CRYPTOCOM_DEVELOPER_PLATFORM_API_KEY` environment variable (handled by
`cryptocom-tools-core`), and there is no on-chain RPC or ethers/web3 usage.

## Supported Instruments

The tools support various trading pairs including:
- `CRO_USDT`
- `BTC_USDT`
- `ETH_USDT`
- And many more...

Instrument names are automatically normalized (e.g., `cro-usdt`, `CRO/USDT` -> `CRO_USDT`).

## License

MIT
