Metadata-Version: 2.5
Name: socialfi-thesis
Version: 0.5.0
Summary: SocialFi token theses — holders-only opinions on a token with the author's real position and live PnL, replies, reactions and a drop-in thesis widget for any crypto app. By CabalSpy ID.
Project-URL: Homepage, https://www.cabalspy.xyz/cabalspy-id/
Project-URL: Documentation, https://docs.cabalspy.xyz/cabalspy-id
Project-URL: Repository, https://github.com/CabalSpy/socialfi-thesis
Project-URL: Issues, https://github.com/CabalSpy/socialfi-thesis/issues
Project-URL: SDK, https://pypi.org/project/cabalspy-id/
Author-email: CabalSpy <contact@cabalspy.xyz>
License-Expression: MIT
License-File: LICENSE
Keywords: base,bnb,cabalspy,cabalspy-id,copy-trading,crypto-login,crypto-social,ethereum,kol,kol-tracker,pnl,python,sdk,social-trading,socialfi,socialfi-thesis,socialfi-widget,solana,token-theses,token-thesis,trading-leaderboard,wallet-tracker,web3-social
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: cabalspy-id<0.6,>=0.5.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: websockets>=14.0; extra == 'dev'
Provides-Extra: stream
Requires-Dist: cabalspy-id[stream]<0.6,>=0.5.0; extra == 'stream'
Description-Content-Type: text/markdown

# socialfi-thesis — token theses for any crypto app (Python)

[![PyPI](https://img.shields.io/pypi/v/socialfi-thesis.svg)](https://pypi.org/project/socialfi-thesis/) [![ci](https://github.com/CabalSpy/socialfi-thesis/actions/workflows/ci.yml/badge.svg)](https://github.com/CabalSpy/socialfi-thesis/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

**socialfi-thesis** brings SocialFi token theses to your app: holders-only opinions on a token, each with the author's real position and live PnL, replies, reactions and moderation — shared across every platform that uses CabalSpy ID. Sync and async.

Part of **[CabalSpy ID](https://id.cabalspy.xyz)** — the SocialFi layer for crypto apps. [Website](https://www.cabalspy.xyz/cabalspy-id/) · [Docs](https://docs.cabalspy.xyz/cabalspy-id) · [API dashboard](https://apidashboard.cabalspy.xyz) · [Full SDK: cabalspy-id](https://github.com/CabalSpy/cabalspy-id-js)

```bash
pip install socialfi-thesis         # live theses: pip install "socialfi-thesis[stream]"
```

```python
from socialfi_thesis import CabalSpyID, ThesisClient

csid = CabalSpyID()  # Data API key: read everything, write in your users' names
theses = csid.list_theses(blockchain="solana", mint=mint, sort="top")
csid.post_thesis(blockchain="solana", mint=mint, body="Accumulating here.", stance="bull", csid_id=user_sub)

with ThesisClient(access_token) as tc:  # public thesis API with the user's access token
    page = tc.list("solana", mint)
```

Contents: the `cabalspy_id.thesis` module. Full reference: [cabalspy-id README — Token theses](https://github.com/CabalSpy/cabalspy-id-python#token-theses).

Versions follow `cabalspy-id`: 0.5.0 depends on `cabalspy-id` 0.5.0. This package contains no code of its own — it re-exports part of `cabalspy-id`, so behaviour, fixes and types are always the same.

## License

MIT
