volatility

Get Volatility Supply Shocks

Detect abnormal collapses in trade volumes: for each partner/product pair with enough sustained activity, flag periods where volume drops well below the pair's historical average (> 2 sigma by default). Returns ranked shock events per flow, each with timeline phases (baseline, decline, disruption, recovery, ...), magnitude, abnormality score and the underlying series. Tunable via the query params documented below; lower thresholds surface more (weaker) shocks. Streams NDJSON.

post/api/volatility/supply-shocks

Request

  • Base URL: https://tradedashboard.eu (the document declares no server; this is the origin it was published from)
  • URL: https://tradedashboard.eu/api/volatility/supply-shocks
  • Auth: none declared

Query parameters

entity_level'partner' | 'reporter'

Dimension to analyse. 'partner' — how concentrated/volatile is the reporter's trade across its trading partners? 'reporter' — how concentrated/volatile is a given partner's trade across EU member states? When 'reporter', the 'partner' query param is required.

partnerstring nullable

Partner country name (English). Required when entity_level='reporter'.

min_abnormalitynumber

Minimum statistical abnormality of the volume crash, in sigma. Lower values flag more (weaker) shocks; higher values flag only extreme events. Default 2.0.

relative_thresholdnumber

Minimum drop relative to peak volume to count as a collapse (e.g. 0.10 = 10% drop). Default 0.10.

min_active_yearsinteger

Consecutive years of regular trade required before a collapse can be flagged. Default 2.

cumulative_sharenumber

Only the top trading partners that together account for this share of total trade are analysed (e.g. 0.80 = top 80%). Default 0.80.

max_tolerated_gapinteger

Consecutive quiet periods allowed within an otherwise stable trading relationship. Default 2.

Request body

reporterstring

Declaring entity: an EU member state, an EU candidate country, Northern Ireland ('XI'), or one of the three aggregate presets ('European Union', 'Euro area', 'EU candidate countries'), or a predefined reporter group name.

reporter_membersstring[] nullable

Explicit member countries for a custom reporter group. Each entry must be an EU member state, EU candidate country, or Northern Ireland. When more than one member is supplied the frame is aggregated into a synthetic group named after 'reporter'.

partner_setstring

Named partner preset, e.g. 'non-EU countries', 'EU countries', 'all countries', or a predefined partner group.

partnersstring[] nullable

Explicit partner-country list that overrides 'partner_set' when present.

period_startstring

Inclusive start of the analysis window, ISO month 'YYYY-MM'.

period_endstring

Inclusive end of the analysis window, ISO month 'YYYY-MM'. Defaults to roughly three months ago — the latest period Eurostat typically has fully reported.

frequencystring

Resampling frequency for the series: 'month', 'quarter' or 'year'.

n_topinteger

Number of top entities (by volume/value) to break out individually in charts.

include_otherboolean

Bundle entities outside the top-N into a single 'Other' bucket.

remove_outliersboolean

Drop extreme unit-price outliers before computing weighted-average prices.

midpointstring nullable

Split point 'YYYY-MM' for the Pattern Shifts tab: the window is cut in two here and the before/after change per entity is reported. Defaults to the middle of the period when omitted.

langstring

Language for translated labels in the response (en, de, fr, es, it, ro).

prodcom_codestring nullable

Specific PRODCOM dataset code to pin for the Net Import Reliance and Trade Intensity tabs, when a single CN code maps to several. Ignored elsewhere.

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.