fintech-algorithms
Using a coding agent? Give it the skill: npx skills add IslamBaraka90/Fintech-Algorithms-Library What it does →

Lags, Leads, and Temporal Dependence

Install and import#

bash
npm install fintech-algorithms
ts
import { lagsLeadsAndTemporalDependence } from "fintech-algorithms/financial-mathematics-statistics-and-data-foundations/financial-time-series-foundations/lags-leads-and-temporal-dependence";

Signature#

lagsLeadsAndTemporalDependence(input)

Worked example#

verified This is the worked example published in the article, replayed by the test suite on every run. The output cannot drift.

Input#

input
{
  "timestamps": [
    "2025-01-01T00:00:00Z",
    "2025-01-02T00:00:00Z",
    "2025-01-03T00:00:00Z",
    "2025-01-04T00:00:00Z",
    "2025-01-05T00:00:00Z",
    "2025-01-06T00:00:00Z"
  ],
  "values": [100, 102, 101, 104, 106, 105],
  "lag": 1,
  "window": 3,
  "resampleSize": 2,
  "period": 3,
  "stationarityTolerance": 3,
  "alpha": 0.4,
  "splitIndex": 4
}

Call#

lagsLeadsAndTemporalDependence(input)

Returns#

object with 2 fields: laggedPairs, leadValues

{
  "laggedPairs": [
    {
      "current": 102,
      "lagged": 100
    },
    {
      "current": 101,
      "lagged": 102
    },
    {
      "current": 104,
      "lagged": 101
    }
  ],
  "leadValues": [102, 101, 104, 106, 105]
}

Diagrams#

Lags, Leads, and Temporal Dependence — article hero
Lags, Leads, and Temporal Dependence — calculation ledger
Lags, Leads, and Temporal Dependence — concept anatomy
Lags, Leads, and Temporal Dependence — failure boundary
Lags, Leads, and Temporal Dependence — method map
Lags, Leads, and Temporal Dependence — scenario contrast

How it works#

This page states the contract — how to call it correctly. The article explains the concept: why it works, and where it breaks.

Read the article →

References#

The rest of the Financial Time-Series Foundations family#