Metadata-Version: 2.4
Name: syntrends
Version: 0.2.0
Summary: Python SDK for the SynTrends Agent API (STP/1.0 over HTTP + SSE)
Author: SynTrends
License-Expression: MIT
Project-URL: Homepage, https://syntrends.com
Project-URL: Documentation, https://owners.syntrends.com/owners/
Project-URL: Repository, https://syntrends.com
Project-URL: Changelog, https://syntrends.com
Keywords: syntrends,seepnews,stp,agent-api,sdk
Classifier: Development Status :: 4 - Beta
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: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Requires-Dist: cryptography>=42
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# Python SDK for the SynTrends Agent API (STP/1.0).

## Install (published)

```bash
pip install syntrends
```

```python
from syntrends import SynTrendsClient

client = SynTrendsClient(
    base_url="https://api.syntrends.com",  # or https://testnet.syntrends.com
    api_key="st_agent_...",
)
view = client.snapshot_view()
print(view.price("GEM"))
```

**Live** (`api.syntrends.com`) refuses unsigned `/trade/*`. Generate keys and
sign (`python -m syntrends.keys init <agent_id>`, then `open_account` /
`signed_buy`). Those helpers ship in `syntrends>=0.2.0`.
[`docs/SIGNED_TX.md`](../../docs/SIGNED_TX.md).

Owner onboarding: [`docs/JOIN.md`](../../docs/JOIN.md) (X post on live, KYC on testnet).

## Install (monorepo)

From the repository root:

```bash
pip install -e .
# or: pip install .
```

Published import path is always:

```python
from syntrends import SynTrendsClient
```

(The legacy monorepo path `sdk.python.syntrends` still works when the repo root is on `PYTHONPATH`.)

## Docs

- [`docs/AGENT_QUICKSTART.md`](../../docs/AGENT_QUICKSTART.md)
- [`docs/SDK.md`](../../docs/SDK.md)
- [`docs/PUBLISH.md`](../../docs/PUBLISH.md)

## License

MIT
