Metadata-Version: 2.4
Name: pyXRocketAPI
Version: 0.1.0
Summary: Python client for the xRocket Pay API
Author: Badiboy
License-Expression: MIT
Project-URL: Homepage, https://github.com/Badiboy/pyXRocketAPI
Project-URL: Documentation, https://docs.xrocket.exchange/api/pay/pay-api-overview
Project-URL: Repository, https://github.com/Badiboy/pyXRocketAPI
Keywords: xrocket,pay,crypto,payments,api
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28
Dynamic: license-file

# pyXRocketAPI

**pyXRocketAPI** is a Python client for the [xRocket Pay API](https://docs.xrocket.exchange/api/pay/pay-api-overview). It supports application information, balances, invoices, cheques, payouts, withdrawals, currency rates, and health checks.

## Installation

```shell
pip install pyXRocketAPI
```

## Quick start

```python
from pyXRocketAPI import xRocketPayAPI

client = xRocketPayAPI(token="your-pay-api-token")
invoice = client.create_invoice(price_currency="USDT", price_amount="10.00")
print(invoice.id, invoice.links.web_link)
```

For integration testing, use the xRocket testnet instead of production:

```python
client = xRocketPayAPI(token="testnet-token", testnet=True)
```

## Safety

The token grants access to the application and must not be committed to source control. Financial POST operations are not retried automatically. Supply and retain the relevant client identifier (`client_invoice_id`, `client_payout_id`, `client_cheque_id`, or `client_withdrawal_id`) so that a timed-out operation can be reconciled safely.

Errors from the API raise `xRocketAPIException`; its `problem_type`, `kind`, `status`, and `instance` attributes expose the RFC 9457 error response.

_AI-supported creation._
