Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt

Use this file to discover all available pages before exploring further.

syrto_search_metric_definitions returns full metric definitions including the name, description, calculation formula, unit of measure, direction (better if higher/lower/near target), and dependency links showing the causal chain between metrics.

​
Use this tool to

  • Understand what a specific financial metric means, how it’s calculated, and what drives it
  • Explore causal relationships between metrics and identify dependencies
  • Resolve a metric name to its slug before calling syrto_get_company_metrics

​
Arguments

​
query
string
required
Keyword (e.g. "profitability", "working capital", "debt") or exact slug (e.g. "ebitda", "roe", "net_working_capital"). Exact slug lookup always returns a single result instantly.
​
top_k
integer
Maximum results for keyword search. Default 5, maximum 20. Ignored for exact slug matches.
​
language
string
"en" for English (default) or "it" for Italian.

​
Returns

A JSON list of metric definitions, each containing:
​
name
string
Human-readable metric name.
​
syrto_code
string
Internal metric identifier (slug). Use as input to syrto_get_company_metrics via the metric_slugs parameter. Use name for display.
​
short_name
string | null
Abbreviated metric name, if available.
​
description
string
Plain-language explanation of what the metric measures.
​
type
string
Metric category.
​
uom
string
Unit of measure (e.g. "EUR", "%", "ratio").
​
better_if
string
"HIGHER", "LOWER", or "NEAR_TARGET".
​
better_if_target
float | null
Target value when better_if is "NEAR_TARGET". null for HIGHER or LOWER metrics.
​
fraction_digits
integer
Number of decimal places for displaying the metric value.
​
calculation_formula
string
How the metric is computed.
​
affects
string[]
Metrics this one feeds into.
​
is_affected_by
string[]
Metrics that drive this one.
​
note
string
Context note about data availability and where to find more on syrto.ai.

​
Example

Look up EBITDA and its dependencies: 
{
  "query": "ebitda"
}
Response (abbreviated): 
[
  {
    "name": "EBITDA",
    "syrto_code": "ebitda",
    "short_name": "EBITDA",
    "description": "Earnings before interest, taxes, depreciation, and amortisation. Measures operating profitability before non-cash charges.",
    "type": "profitability",
    "uom": "EUR",
    "better_if": "HIGHER",
    "better_if_target": null,
    "fraction_digits": 2,
    "calculation_formula": "Operating profit + Depreciation + Amortisation",
    "affects": ["EBITDA Margin", "Net Financial Position / EBITDA"],
    "is_affected_by": ["Revenues", "Operating Costs"],
    "note": "..."
  }
]