Python SDK

pip install gildea

from gildea_sdk import Gildea

client = Gildea()  # reads GILDEA_API_KEY from env

signals = client.signals.list(entity="NVIDIA", limit=5)
for s in signals["data"]:
    print(s["title"])

client = Gildea(api_key="gld_your_key")

# List signals (all filters optional — defaults to most recent)
client.signals.list(entity="NVIDIA", limit=5)
client.signals.list(q="GPU supply chain", content_type="analysis")

# Get full decomposition
client.signals.get("0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7")
client.signals.get("0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7", include="evidence", verification_detail="full")

# List entities
client.entities.list(type_primary="organization", limit=10)
client.entities.list(q="OpenAI", sort="trend")

# Get entity profile with related entities
client.entities.get("NVIDIA")

# Filter by interpretation fields (composable)
client.entities.list(direction="Rising", confidence="Significant", sort="trend", limit=5)
client.entities.list(scale="Large", stability="Steady")
client.entities.list(direction="New", sort="first_seen", limit=10)

# List all themes or filter by axis
client.themes.list()
client.themes.list(axis="value_chain")

# Get theme detail with related themes
client.themes.get("value_chain", "Foundation Models")

# Hybrid dense + sparse search with cross-encoder rerank, over all verified text units
client.search("AI chip supply constraints", limit=5)
client.search("AI chip supply constraints", unit_type="analysis_claim", entity="NVIDIA")

for signal in client.signals.list_all(entity="NVIDIA"):
    print(signal["title"])

for entity in client.entities.list_all(type_primary="organization"):
    print(entity["display_name"])

from gildea_sdk import (
    Gildea,
    AuthenticationError,
    NotFoundError,
    RateLimitError,
    BadRequestError,
    APIError,
)

client = Gildea()

try:
    client.signals.get("sig_nonexistent")
except NotFoundError as e:
    print(f"Not found: {e}")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except AuthenticationError as e:
    print(f"Auth failed: {e}")
except APIError as e:
    print(f"API error ({e.status}): {e}")

client = Gildea(
    api_key="gld_...",                     # or set GILDEA_API_KEY env var
    base_url="https://api.gildea.ai",      # override for self-hosted
    timeout=30.0,                          # request timeout in seconds
)

with Gildea() as client:
    signals = client.signals.list(q="AI", limit=5)