fundis 1.1.0

Python client for Fundis intelligence data - events, signals, and patterns from SentiChain.

Fundis

Python client for Fundis intelligence data - events, signals, and patterns from SentiChain.

Fundis is the intelligence engine behind SentiMove. This package provides programmatic access to its structured output.

Installation

pip install fundis

Quick Start

from fundis import FundisClient

client = FundisClient()

# Get classified events for an asset
events = client.get_events("BTC")
for event in events:
    print(f"[{event.type}] {event.sentiment}: {event.summary}")

# Get a directional signal with rationale
signal = client.get_signal("BTC")
print(f"Direction: {signal.direction}, Confidence: {signal.confidence}")
print(f"Rationale: {signal.rationale}")
for cat, summary in signal.categories.items():
    if summary:
        print(f"  {cat}: {summary}")

# List supported tickers
tickers = client.list_tickers()
print(tickers)  # ['BTC', 'ETH', 'SOL', 'XRP', 'DOGE', 'HYPE']

API Reference

FundisClient(api_key="", base_url="https://api.fundis.ai", timeout=30.0)

Create a client instance. Intelligence data is publicly available. An API key is only needed for billing-related operations on SentiChain.

client.get_events(ticker) -> list[Event]

Fetch the latest classified events for a ticker. Each event contains:

Field	Type	Description
timestamp	str	ISO 8601 timestamp
type	str	Event category: macro, industry, price, or asset
sentiment	str	bullish, bearish, or neutral
summary	str	One-sentence event description
is_pattern	bool	Whether this event is part of a detected pattern
pattern_keywords	list[str]	Keywords linking pattern events

client.get_signal(ticker) -> Signal

Fetch the latest directional signal for a ticker. Returns:

Field	Type	Description
direction	str	LONG, SHORT, or FLAT
confidence	float	0.0 to 1.0
rationale	str	1-2 sentence explanation of the call
categories	dict	One-sentence summaries for macro, industry, price, asset
patterns	list[Pattern]	Detected event patterns with keywords and descriptions
bullish_count	int	Number of bullish events
bearish_count	int	Number of bearish events
total_count	int	Total event count

client.list_tickers() -> list[str]

Return the list of supported ticker symbols.

Requirements

• Python 3.10+

Links

• Fundis.ai - Intelligence engine landing page
• SentiMove - 3D consumer product powered by Fundis
• SentiChain - Blockchain platform and API keys
• GitHub - Source code
• PyPI - Package registry

License

MIT License - see LICENSE for details.