Spectra
Explorar docs

scripting

Gramática

Keywords, tipos y la gramática de expresiones del DSL de Spectra en EBNF.


El DSL de Spectra tiene una gramática pequeña. Si has usado Pine Script o TypeScript, casi todo te resultará familiar — la superficie es deliberadamente compacta.

Keywords

let const fn if else for while in
return yield break continue
true false null
output plot mark notify draw_zone
buy sell sell_all

Tipos primitivos

int       // entero con signo de 64 bits
float     // double de 64 bits
bool      // true | false
str       // cadena UTF-8
time      // timestamp de la barra (epoch ms)
series<T> // ventana deslizante histórica de T
color     // nombre de tema o hex

Expresiones en EBNF

expr     = literal | ident | call | binop | unop | index | block ;
binop    = expr ( "+" | "-" | "*" | "/" | "%" |
                  "==" | "!=" | "<" | ">" | "<=" | ">=" |
                  "and" | "or" ) expr ;
unop     = ( "-" | "not" ) expr ;
call     = ident "(" [ args ] ")" ;
args     = expr ("," expr)* | named ("," named)* ;
named    = ident ":" expr ;
index    = expr "[" expr "]" ;        // series[N] lee N barras atrás
block    = "{" stmt* "}" ;

Un script completo

let fast = sma(close, 12)
let slow = sma(close, 26)
let signal = cross_up(fast, slow)
plot(fast, color: accent)
plot(slow, color: text_1)
output signal

La línea output es el valor primario del script. El gráfico, el backtester y el cloud worker la leen.