Inputs

Overview

input.* functions declare user-configurable parameters. Each call appears in the Inputs panel as a form control. You must call them at the top level of your script - never inside onBar.

const length = input.int("Length", 14);
const src    = input.source("Source", "close");
const useEma = input.bool("Use EMA", false);

Function reference

number

Integer spinner. opts: { min, max, step, group }.

const len = input.int("Period", 20, { min: 2, max: 500, step: 1 });

number

Float spinner. Same opts as input.int.

const mult = input.float("Multiplier", 2.0, { min: 0.1, max: 10, step: 0.1 });

boolean

Checkbox toggle.

const showLabels = input.bool("Show labels", true);

string

Text field. Pass opts.options for a dropdown.

const mode = input.string("Mode", "fast", { options: ["fast", "slow", "adaptive"] });
const note = input.string("Label text", "Signal");

string

Color picker. Returns a hex color string.

const bullColor = input.color("Bull color", "#22c55eFF");
const bearColor = input.color("Bear color", "#ef4444FF");

(offset?) => number | null

OHLCV source selector. Returns a function you pass directly to ta.*. The default must be one of "open", "high", "low", "close", "hl2", "hlc3", "ohlc4".

const src = input.source("Source", "close");
// src is now a function: src(0) === ctx.close(0)
ta.ema(src, 20); // pass src directly, do not call it

Form control mapping

Input type	Rendered control
`input.int` / `input.float`	Number spinner with optional min/max/step
`input.bool`	Checkbox
`input.string` with `options`	Dropdown select
`input.string` without `options`	Text field
`input.color`	Color picker
`input.source`	OHLCV source dropdown

Grouping inputs

Use the group option to visually separate inputs in the panel:

const fastLen = input.int("Fast", 12, { group: "MACD" });
const slowLen = input.int("Slow", 26, { group: "MACD" });
const sigLen  = input.int("Signal", 9, { group: "MACD" });
const lineCol = input.color("Line color", "#22c55eFF", { group: "Display" });

The source function pattern

input.source returns an (offset?) => number | null function - the same shape as ctx.close, ctx.open, etc. Pass it directly to ta.*; do not call it yourself:

const src = input.source("Source", "close");

onBar(() => {
  const val = ta.ema(src, 14);  // correct: pass src as a function reference
  // const val = ta.ema(src(), 14);  // WRONG: src() returns a scalar, not a source
});

Calling input.* inside onBar throws a RuntimeError. Move all declarations to the top level.

Script lifecycle

Why top-level code runs once and onBar runs per bar.

Bar context

Built-in OHLCV accessors that share the source function shape.

Getting Started

Core Concepts

Plotting

Drawing Entities

Technical Analysis

Utility Namespaces

Examples

Reference

Overview

Function reference

Form control mapping

Grouping inputs

The source function pattern

Script lifecycle

Bar context

​Overview

​Function reference

​Form control mapping

​Grouping inputs

​The source function pattern

​Related pages

Script lifecycle

Bar context

Overview

Function reference

Form control mapping

Grouping inputs

The source function pattern

Related pages