Metadata-Version: 2.5
Name: socialfi-api
Version: 0.5.0
Summary: SocialFi API — add a social layer to any app: login with X + verified wallets, live trades and PnL of your users, leaderboards and copy trading on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. 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-api
Project-URL: Issues, https://github.com/CabalSpy/socialfi-api/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,oidc,openid-connect,pnl,python,sdk,social-trading,socialfi,socialfi-api,socialfi-sdk,solana,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-api — the SocialFi API for any app (Python)

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

**socialfi-api** adds a social layer to any crypto app: login with X, wallets verified by a tiny on-chain payment, reviewed KOL badges, live trades and PnL of your users, leaderboards and copy trading — on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. 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-api            # live trade stream: pip install "socialfi-api[stream]"
```

```python
from socialfi_api import CabalSpyID, CabalSpyIDAuth, verify_webhook

auth = CabalSpyIDAuth("csid_...", client_secret=os.environ["CSID_CLIENT_SECRET"], redirect_uri="https://your.app/callback")
req = auth.create_authorization_url(scope=["openid", "profile", "wallets"])

csid = CabalSpyID()  # reads CABALSPY_ID_API_KEY / CABALSPY_API_KEY
board = csid.leaderboard(blockchain="solana", period="7d", sort="pnl_usd")
```

Contents: `CabalSpyID` / `AsyncCabalSpyID` (Data API), `CabalSpyIDStream`, `CabalSpyIDAuth` (OIDC), `verify_webhook`, errors and response types — the `cabalspy_id.api` module. Full reference: [cabalspy-id README](https://github.com/CabalSpy/cabalspy-id-python#readme).

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
