Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.
Finance Templates
Financial document analysis and extraction.
Overview
Finance templates are optimized for extracting structured information from financial documents.
Templates
earnings_summary
Type: model
Purpose: Extract key metrics from earnings reports
Best for:
- Quarterly earnings (10-Q)
- Annual reports (10-K)
- Earnings call transcripts
Fields:
| Field | Type | Description |
|---|---|---|
company_name |
str | Company name |
quarter |
str | Fiscal quarter |
revenue |
float | Total revenue |
net_income |
float | Net income |
eps |
float | Earnings per share |
yoy_growth |
float | Year-over-year growth |
=== "CLI"
```bash
he parse 10q.md -t finance/earnings_summary -l en
```
=== "Python"
```python
ka = Template.create("finance/earnings_summary", "en")
result = ka.parse(earnings_text)
print(f"Revenue: ${result.data.revenue}B")
print(f"EPS: ${result.data.eps}")
```
ownership_graph
Type: graph
Purpose: Extract company ownership structures
Best for:
- Shareholder reports
- Proxy statements
- Corporate structures
Entities:
- Companies
- Shareholders
- Subsidiaries
Relations:
owns— Ownership relationshipscontrols— Control relationshipssubsidiary_of— Subsidiary relationships
=== "CLI"
```bash
he parse proxy.md -t finance/ownership_graph -l en
```
=== "Python"
```python
ka = Template.create("finance/ownership_graph", "en")
result = ka.parse(proxy_statement)
# Build index for interactive search/chat in visualization
result.build_index()
result.show() # Shows ownership network with interactive features
```
event_timeline
Type: temporal_graph
Purpose: Extract financial events with dates
Best for:
- Corporate event histories
- M&A timelines
- Market events
Features:
- Event dates
- Event types (merger, acquisition, IPO, etc.)
- Related entities
=== "CLI"
```bash
he parse history.md -t finance/event_timeline -l en
```
=== "Python"
```python
ka = Template.create("finance/event_timeline", "en")
result = ka.parse(history_text)
print(f"Events: {len(result.nodes)}")
for node in result.nodes:
print(f" - {node.name}")
```
risk_factor_set
Type: set
Purpose: Extract unique risk factors
Best for:
- Risk factor sections
- Due diligence reports
- Risk assessments
=== "CLI"
```bash
he parse 10k.md -t finance/risk_factor_set -l en
```
=== "Python"
```python
ka = Template.create("finance/risk_factor_set", "en")
result = ka.parse(risk_section)
print(f"Found {len(result.data.items)} risk factors")
for risk in result.data.items:
print(f" - {risk}")
```
sentiment_model
Type: model
Purpose: Extract sentiment indicators
Best for:
- News articles
- Analyst reports
- Social media sentiment
Fields:
| Field | Type | Description |
|---|---|---|
sentiment |
str | Overall sentiment (positive/negative/neutral) |
confidence |
float | Confidence score |
key_points |
list[str] | Key sentiment indicators |
=== "CLI"
```bash
he parse article.md -t finance/sentiment_model -l en
```
=== "Python"
```python
ka = Template.create("finance/sentiment_model", "en")
result = ka.parse(article_text)
print(f"Sentiment: {result.data.sentiment}")
print(f"Confidence: {result.data.confidence}")
for point in result.data.key_points:
print(f" - {point}")
```
Use Cases
Use Case 1: Quarterly Report Analysis
from hyperextract import Template
# Extract earnings
ka = Template.create("finance/earnings_summary", "en")
q1 = ka.parse(q1_report)
q2 = ka.parse(q2_report)
# Compare
print(f"Q1 Revenue: ${q1.data.revenue}B")
print(f"Q2 Revenue: ${q2.data.revenue}B")
print(f"Growth: {(q2.data.revenue - q1.data.revenue) / q1.data.revenue * 100:.1f}%")
Use Case 2: Ownership Structure
ka = Template.create("finance/ownership_graph", "en")
ownership = ka.parse(proxy_statement)
# Find major shareholders
shareholders = [
e for e in ownership.data.entities
if e.type == "shareholder"
]
for sh in sorted(shareholders, key=lambda x: x.stake, reverse=True)[:5]:
print(f"{sh.name}: {sh.stake}%")
Use Case 3: Risk Assessment
ka = Template.create("finance/risk_factor_set", "en")
risk_factors = ka.parse(risk_section)
# Categorize risks
for risk in risk_factors.data.items:
if "regulatory" in risk.lower():
print(f"Regulatory Risk: {risk}")
elif "market" in risk.lower():
print(f"Market Risk: {risk}")
Data Sources
These templates work well with:
- SEC filings (10-K, 10-Q, 8-K)
- Earnings call transcripts
- Investor presentations
- Analyst reports
- Financial news
Tips
- Use earnings_summary for quick metrics — Fast extraction of key numbers
- Use ownership_graph for structure — Visualize corporate hierarchies
- Use event_timeline for history — Track corporate events
- Combine templates — Use multiple templates for comprehensive analysis