Skip to content
ChartDeck ChartScript docs Account Open the terminal

math

Mathematics.

#Functions

#math.absfunction

The absolute value.

math.abs(number: num): num
ParameterTypeDescription
numbernumThe number.

Returns num.

Example

ChartScriptFragmentOpen in editor
const a = math.abs(close - open)

Since ChartScript 1

#math.acosfunction

Trigonometric acos.

math.acos(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.acos(0.5)

Since ChartScript 1

#math.asinfunction

Trigonometric asin.

math.asin(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.asin(0.5)

Since ChartScript 1

#math.atanfunction

Trigonometric atan.

math.atan(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.atan(0.5)

Since ChartScript 1

#math.avgfunction

The average of the arguments.

math.avg(number0: float, number1: float, …): float
ParameterTypeDescription
number0floatThe first number.
number1floatThe second number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const a = math.avg(open, high, low, close)

Since ChartScript 1

#math.ceilfunction

Rounds up.

math.ceil(number: num): int
ParameterTypeDescription
numbernumThe number.

Returns int.

Example

ChartScriptFragmentOpen in editor
const c = math.ceil(close)

Since ChartScript 1

#math.cosfunction

Trigonometric cos.

math.cos(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.cos(0.5)

Since ChartScript 1

#math.expfunction

e to the power number.

math.exp(number: float): float
ParameterTypeDescription
numberfloatThe number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const e = math.exp(1)

Since ChartScript 1

#math.floorfunction

Rounds down.

math.floor(number: num): int
ParameterTypeDescription
numbernumThe number.

Returns int.

Example

ChartScriptFragmentOpen in editor
const f = math.floor(close)

Since ChartScript 1

#math.logfunction

Natural logarithm.

math.log(number: float): float
ParameterTypeDescription
numberfloatThe number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const l = math.log(close)

Since ChartScript 1

#math.log10function

Base-10 logarithm.

math.log10(number: float): float
ParameterTypeDescription
numberfloatThe number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const l = math.log10(volume)

Since ChartScript 1

#math.maxfunction

The largest argument (na when all are na).

math.max(value1: num, value2: num, …): num
ParameterTypeDescription
value1numThe first value.
value2numThe second value.

Returns num.

Example

ChartScriptFragmentOpen in editor
const m = math.max(open, close)

Since ChartScript 1

#math.minfunction

The smallest argument (na when all are na).

math.min(value1: num, value2: num, …): num
ParameterTypeDescription
value1numThe first value.
value2numThe second value.

Returns num.

Example

ChartScriptFragmentOpen in editor
const m = math.min(open, close)

Since ChartScript 1

#math.powfunction

base to the power exponent.

math.pow(base: float, exponent: float): float
ParameterTypeDescription
basefloatThe base.
exponentfloatThe exponent.

Returns float.

Example

ChartScriptFragmentOpen in editor
const p = math.pow(close, 2)

Since ChartScript 1

#math.randomfunction

A pseudo-random number in [min, max); the default seed is fixed per script, so charts and alerts agree.

math.random({ min?: float = 0, max?: float = 1, seed?: simple int = na }): float
ParameterTypeDescription
minfloatdefault 0The smallest value.
maxfloatdefault 1The largest value.
seedsimple intdefault naFixed seed; the default seed is fixed per script.

Returns float.

Example

ChartScriptFragmentOpen in editor
const r = math.random(0, 1)

Since ChartScript 1

#math.roundfunction

Rounds half away from zero; with precision, to that many decimals.

math.round(number: num): int
math.round(number: num, precision: int): float
ParameterTypeDescription
numbernumThe number.
precisionintDecimals shown.

Returns int.

Example

ChartScriptFragmentOpen in editor
const r = math.round(close, 2)

Since ChartScript 1

#math.round_to_mintickfunction

Rounds to the market tick size.

math.round_to_mintick(number: float): float
ParameterTypeDescription
numberfloatThe number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const r = math.round_to_mintick(hl2)

Since ChartScript 1

#math.signfunction

1, -1 or 0.

math.sign(number: num): num
ParameterTypeDescription
numbernumThe number.

Returns num.

Example

ChartScriptFragmentOpen in editor
const s = math.sign(close - open)

Since ChartScript 1

#math.sinfunction

Trigonometric sin.

math.sin(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.sin(0.5)

Since ChartScript 1

#math.sqrtfunction

Square root.

math.sqrt(number: float): float
ParameterTypeDescription
numberfloatThe number.

Returns float.

Example

ChartScriptFragmentOpen in editor
const s = math.sqrt(volume)

Since ChartScript 1

#math.sumfunction

Rolling sum over length bars.

math.sum(source: float, length: simple int): float
ParameterTypeDescription
sourcefloatThe series to read.
lengthsimple intNumber of bars.

Returns float.

Example

ChartScriptFragmentOpen in editor
const s = math.sum(volume, 20)

Since ChartScript 1

#math.tanfunction

Trigonometric tan.

math.tan(angle: float): float
ParameterTypeDescription
anglefloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const v = math.tan(0.5)

Since ChartScript 1

#math.todegreesfunction

Radians to degrees.

math.todegrees(radians: float): float
ParameterTypeDescription
radiansfloatAn angle in radians.

Returns float.

Example

ChartScriptFragmentOpen in editor
const d = math.todegrees(math.pi)

Since ChartScript 1

#math.toradiansfunction

Degrees to radians.

math.toradians(degrees: float): float
ParameterTypeDescription
degreesfloatAn angle in degrees.

Returns float.

Example

ChartScriptFragmentOpen in editor
const r = math.toradians(180)

Since ChartScript 1

#Constants

NameTypeDescription
math.efloatEuler's number (2.71828...).
math.phifloatThe golden ratio (1.61803...).
math.pifloatPi (3.14159...).
math.rphifloatThe reciprocal golden ratio (0.61803...).

The ChartScript documentation is in English for now; translations will follow.