Metric definitions

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

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.

integer

Maximum results for keyword search. Default 5, maximum 20. Ignored for exact slug matches.

string

"en" for English (default) or "it" for Italian.

Returns

A JSON list of metric definitions, each containing:

string

Human-readable metric name.

string

Internal metric identifier (slug). Use as input to syrto_get_company_metrics via the metric_slugs parameter. Use name for display.

string | null

Abbreviated metric name, if available.

string

Plain-language explanation of what the metric measures.

string

Metric category.

string

Unit of measure (e.g. "EUR", "%", "ratio").

string

"HIGHER", "LOWER", or "NEAR_TARGET".

float | null

Target value when better_if is "NEAR_TARGET". null for HIGHER or LOWER metrics.

integer

Number of decimal places for displaying the metric value.

string

How the metric is computed.

string[]

Metrics this one feeds into.

string[]

Metrics that drive this one.

string

Context note about data availability and where to find more on syrto.ai.

string

Link to the Syrto web app, where you can explore more data and insights.

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": "..."
  }
]

Getting started

Tools

Metric definitions

Use this tool to

Arguments

Returns

Example

​Use this tool to

​Arguments

​Returns

​Example

Use this tool to

Arguments

Returns

Example