fintech-algorithms

Accumulation/Distribution Line

Install and import

bash
npm install fintech-algorithms
ts
import { accumulation_distribution_line } from "fintech-algorithms/technical-indicators/volume-indicators/accumulation-distribution-line";

Signature

accumulation_distribution_line(high, low, close, volume, initial)

Weights each bar's volume by where the close sat within that bar's range, then accumulates. Unlike OBV it distinguishes a close at the high from a close barely above the open.

Parameters

NameTypeNotes
highnumber[]Per-bar high prices, chronological.
lownumber[]Per-bar low prices, chronological.
closenumber[]Per-bar closing prices, chronological.
volumenumber[]Per-bar traded volume, aligned index-for-index with the price series.
initialnumberStarting value of the accumulation.
optional

Returns

Record<string, (number | null)[]> · length same-as-input

Parallel series: range, money_flow_multiplier, volume, money_flow_volume and adl.

Warm-up

The first 0 positions are null. Defined from the first bar; a zero-range bar contributes nothing rather than dividing by zero.

Errors

  • When the input series are not all the same length — throws RangeError

Complexity: time O(n), space O(n).

Worked example

executed Captured by running this function on the input its own test provides. Real output of real code — but not asserted against a published figure.

Input

high
[101.05, 101.52482, 102.098461, 102.729464, 103.36806, 103.963227]

Showing 6 of 120 elements.

low
[99.4, 99.462904, 99.936275, 100.512674, 101.151059, 101.802588]

Showing 6 of 120 elements.

close
[100.28, 100.686113, 101.200346, 101.789282, 102.408843, 103.010585]

Showing 6 of 120 elements.

volume
[990000, 1066468.036, 1130033.236, 1170141.961, 1180511.26, 1160272.794]

Showing 6 of 120 elements.

Call

accumulation_distribution_line(high, low, close, volume, initial)

Returns

object with 5 fields: range, money_flow_multiplier, volume, money_flow_volume, adl

{
  "range": [
    1.6499999999999915,
    2.0619160000000107,
    2.1621860000000055,
    2.216789999999989,
    2.2170009999999962,
    2.1606390000000033
  ],
  "money_flow_multiplier": [
    0.06666666666666667,
    0.1864780136533253,
    0.16925278398805474,
    0.1517626838807486,
    0.1346715675816141,
    0.118184944361371
  ],
  "volume": [990000, 1066468.036, 1130033.236, 1170141.961, 1180511.26, 1160272.794],
  "money_flow_volume": [
    66000,
    198872.84097804304,
    191261.2711920305,
    177583.88452284224,
    158981.30193194642,
    137126.7756029025
  ],
  "adl": [
    66000,
    264872.84097804304,
    456134.11217007355,
    633717.9966929158,
    792699.2986248622,
    929826.0742277647
  ]
}

Other exports

This module also exports obv, chaikin_money_flow, money_flow_index, volume_price_trend, force_index. Every module additionally exports run as an alias of its primary function, and a meta object carrying its catalog id, domain, family, shape and article URL.

Diagrams

Accumulation/Distribution Line — accumulation distribution line comparison
Accumulation/Distribution Line — accumulation distribution line mechanism

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

  • Accumulation Distribution (ADL) — TradingView
  • Chaikin Oscillator — TradingView
  • Volume — TradingView
  • TA-Lib function API and volume indicators — TA-Lib
  • Consolidated Tape — U.S. Securities and Exchange Commission, Investor.gov
  • Closing Price — U.S. Securities and Exchange Commission, Investor.gov
  • What is Volume? — CME Group
  • Claim-role ledger
  • Evidence boundary
  • Enhanced claim-to-source map
  • Public evidence boundary