circle-intelligence 0.1.0

Python SDK for Circle Intelligence — F.I.R.E. economy real-time signal detection

Circle Intelligence SDK

Python SDK for Circle Intelligence — real-time F.I.R.E. economy signal detection via 7-agent AI cascade.

Install

pip install circle-intelligence              # core (browsing, search, chat)
pip install circle-intelligence[wallet]       # + wallet authentication
pip install circle-intelligence[payment]      # + USDC payment flow

Quick Start

from circle_intelligence import CircleSDK

# Free tier — no auth needed
sdk = CircleSDK("https://circle.news")
signals = sdk.get_recent_signals(limit=3)
entities = sdk.get_kg_entities(search="Bitcoin")
briefs = sdk.get_briefs(limit=5)

# Premium tier — with API key
sdk = CircleSDK("https://circle.news", api_key="circ_your_key")
results = sdk.search_signals("DeFi bridge exploit")
analytics = sdk.get_kg_analytics(days=7)
response = sdk.chat(signal_id=1744, messages=[{"role": "user", "content": "What happened?"}])

Features

Feature	Free	Premium
Recent signals	6h delay, 3 max	Real-time, 100 max
Daily briefs	Yes	Yes
Knowledge graph browsing	Yes	Yes
KG analytics + cross-sector	No	Yes
Semantic search	No	Yes
RAG-powered chat	No	Yes
Simulator execution	No	Yes
Research creation	No	Yes
Depth tree details	No	Yes

Wallet Authentication (for agents)

from eth_account import Account
from eth_account.messages import encode_defunct

private_key = "0xYOUR_PRIVATE_KEY"
wallet = Account.from_key(private_key).address

result = sdk.authenticate(
    wallet_address=wallet,
    sign_fn=lambda msg: Account.sign_message(
        encode_defunct(text=msg), private_key
    ).signature.hex(),
)

Documentation

Full API reference and examples at circle.news/docs