![\"PineTS\"](\"./.github/images/banner.png\")
\r\n\r\n \r\n
\r\n Pine Script® runtime for JavaScript
\r\n Run TradingView® indicators in Node.js, browsers, and any JS environment.\r\n
\r\n ![\"Backed](\"https://img.shields.io/badge/Backed_by-LuxAlgo-4185DD.svg?style=flat-square\"){kind=icon}
\r\n ![\"npm](\"https://img.shields.io/npm/v/pinets.svg?style=flat-square\")
\r\n ![\"License\"](\"https://img.shields.io/badge/License-AGPL--3.0%20%2F%20Commercial-blue.svg?style=flat-square\"){kind=icon}
\r\n ![\"Coverage\"](\"./.github/badges/coverage.svg\")
\r\n ![\"API](\"./.github/badges/api-coverage.svg\")
\r\n ![\"Documentation\"](\"https://img.shields.io/badge/docs-luxalgo-4185DD?style=flat-square\"){kind=icon}
![\"Mentioned](\"https://awesome.re/mentioned-badge.svg\"){kind=icon}
\r\n
\r\n Quick Start •\r\n Features •\r\n Usage •\r\n API Coverage •\r\n Docs •\r\n Vela •\r\n AI Agents\r\n
\r\n\r\n## What is PineTS?\r\n\r\nPineTS is a TypeScript runtime for [Pine Script®](https://www.TradingView.com/pine-script-docs/welcome/). It transpiles native v6 or v5 source and executes it with the same time series model: lookbacks, incremental TA, and plot outputs you can read from code.\r\n\r\nYou write the indicator once. PineTS runs it on your data, in your process.\r\n\r\n**[Documentation](https://docs.luxalgo.com/developers/pinets)**\r\n\r\n```javascript\r\nimport { PineTS, Provider } from 'pinets';\r\n\r\nconst pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);\r\n\r\n// Run native Pine Script® directly\r\nconst { plots } = await pineTS.run(`\r\n//@version=6\r\nindicator(\"EMA Cross\")\r\nplot(ta.ema(close, 9), \"Fast\", color.blue)\r\nplot(ta.ema(close, 21), \"Slow\", color.red)\r\n`);\r\n```\r\n\r\n> ***Disclaimer**: PineTS is an independently developed open source compiler and runtime engine. LuxAlgo Global, LLC and the PineTS project are NOT affiliated with, sponsored by, endorsed by, or in any way officially associated with TradingView, Inc. \"Pine Script®\" and \"TradingView®\" are registered trademarks of TradingView, Inc.*\r\n\r\n\r\n\r\n## Why PineTS?\r\n\r\nPine Script® is built for the chart. PineTS is built for everything around it.\r\n\r\n\r\n| You need | PineTS gives you |\r\n| --------------------------------------------------- | ---------------------------------------------- |\r\n| Indicators on your own infrastructure | Run them in Node.js, Deno, Bun, or the browser |\r\n| Values you can pass to a bot, alert, or ML pipeline | Raw plot series as plain JavaScript |\r\n| Data from Binance, a CSV, or your own API | Built in providers, or pass an OHLCV array |\r\n| The same script you already wrote | Native Pine Script® v6, no rewrite |\r\n\r\n\r\n\r\n\r\n## Quick Start\r\n\r\n\r\n\r\n### Installation\r\n\r\n```bash\r\nnpm install pinets\r\n```\r\n\r\n\r\n\r\n### Hello World\r\n\r\nA minimal example:\r\n\r\n```javascript\r\nimport { PineTS, Provider } from 'pinets';\r\n\r\n// Initialize with Binance data\r\nconst pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);\r\n\r\n// Calculate a simple moving average\r\nconst { plots } = await pineTS.run(`\r\n//@version=6\r\nindicator(\"My First Indicator\")\r\nsma20 = ta.sma(close, 20)\r\nplot(sma20, \"SMA 20\")\r\n`);\r\n\r\nconsole.log('SMA values:', plots['SMA 20'].data);\r\n```\r\n\r\n`plots` is a map of series you can log, store, or feed into the rest of your stack.\r\n\r\n## Features\r\n\r\n- **Native Pine Script® v6**: run original TradingView® code directly *(experimental)*\r\n- **60+ TA functions**: SMA, EMA, RSI, MACD, Bollinger Bands, and more\r\n- **Time series semantics**: lookbacks, `var` / `let` persistence, bar state\r\n- **Live streaming**: recalculate on new bars with an event based API\r\n- **Multiple timeframes**: `request.security()` for MTF indicators\r\n- **High precision**: matches TradingView®'s calculation precision\r\n- **Your data**: Binance, FMP, Alpaca, or any OHLCV array\r\n\r\n\r\n\r\n### Two Ways to Write Indicators\r\n\r\nPineTS accepts native Pine Script® or a JavaScript friendly syntax. Both compile to the same runtime.\r\n\r\n**Native Pine Script®**\r\n\r\n```pinescript\r\n//@version=6\r\nindicator(\"RSI Strategy\")\r\n\r\nrsi = ta.rsi(close, 14)\r\nsma = ta.sma(rsi, 10)\r\n\r\nplot(rsi, \"RSI\")\r\nplot(sma, \"Signal\")\r\n```\r\n\r\n\r\n**PineTS Syntax (JavaScript)**\r\n\r\n```javascript\r\n//@PineTS\r\nindicator('RSI Strategy');\r\n\r\nconst rsi = ta.rsi(close, 14);\r\nconst sma = ta.sma(rsi, 10);\r\n\r\nplot(rsi, 'RSI');\r\nplot(sma, 'Signal');\r\n```\r\n\r\n\r\n\r\n## Usage\r\n\r\n\r\n\r\n### Running Native Pine Script®\r\n\r\nPass Pine Script® source to `pineTS.run()` and read the calculated series from `plots`:\r\n\r\n```javascript\r\nimport { PineTS, Provider } from 'pinets';\r\n\r\nconst pineTS = new PineTS(Provider.Binance, 'BTCUSDT', 'D', 200);\r\n\r\nconst { plots } = await pineTS.run(`\r\n//@version=6\r\nindicator(\"MACD\", overlay=false)\r\n\r\n[macdLine, signalLine, hist] = ta.macd(close, 12, 26, 9)\r\n\r\nplot(macdLine, \"MACD\", color.blue)\r\nplot(signalLine, \"Signal\", color.orange)\r\nplot(hist, \"Histogram\", color.gray, style=plot.style_histogram)\r\n`);\r\n\r\n// Access the calculated values\r\nconsole.log('MACD Line:', plots['MACD'].data);\r\nconsole.log('Signal Line:', plots['Signal'].data);\r\n```\r\n\r\n\r\n\r\n### Using PineTS Syntax\r\n\r\nThe same indicators can be written as a JavaScript function using `$.data` and `$.pine`:\r\n\r\n```javascript\r\nimport { PineTS, Provider } from 'pinets';\r\n\r\nconst pineTS = new PineTS(Provider.Binance, 'ETHUSDT', '4h', 100);\r\n\r\nconst { plots } = await pineTS.run(($) => {\r\n const { close, high, low } = $.data;\r\n const { ta, plot, plotchar } = $.pine;\r\n\r\n // Calculate indicators\r\n const ema9 = ta.ema(close, 9);\r\n const ema21 = ta.ema(close, 21);\r\n const atr = ta.atr(14);\r\n\r\n // Detect crossovers\r\n const bullish = ta.crossover(ema9, ema21);\r\n const bearish = ta.crossunder(ema9, ema21);\r\n\r\n // Plot results\r\n plot(ema9, 'Fast EMA');\r\n plot(ema21, 'Slow EMA');\r\n plotchar(bullish, 'Buy Signal');\r\n plotchar(bearish, 'Sell Signal');\r\n\r\n return { ema9, ema21, atr, bullish, bearish };\r\n});\r\n```\r\n\r\n\r\n\r\n### Streaming Live Data\r\n\r\n`pineTS.stream()` recalculates on new bars and emits plot updates:\r\n\r\n```javascript\r\nimport { PineTS, Provider } from 'pinets';\r\n\r\nconst pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1m');\r\n\r\nconst stream = pineTS.stream(\r\n `\r\n //@version=6\r\n indicator(\"Live RSI\")\r\n plot(ta.rsi(close, 14), \"RSI\")\r\n `,\r\n { live: true, interval: 1000 },\r\n);\r\n\r\nstream.on('data', (ctx) => {\r\n const rsi = ctx.plots['RSI'].data.slice(-1)[0].value;\r\n console.log(`RSI: ${rsi.toFixed(2)}`);\r\n\r\n if (rsi < 30) console.log('Oversold!');\r\n if (rsi > 70) console.log('Overbought!');\r\n});\r\n\r\nstream.on('error', (err) => console.error('Stream error:', err));\r\n```\r\n\r\n\r\n\r\n### Custom Data Source\r\n\r\nYou can also pass your own OHLCV array instead of a market data provider:\r\n\r\n```javascript\r\nimport { PineTS } from 'pinets';\r\n\r\n// Your own OHLCV data\r\nconst candles = [\r\n { open: 100, high: 105, low: 99, close: 103, volume: 1000, openTime: 1704067200000 },\r\n { open: 103, high: 108, low: 102, close: 107, volume: 1200, openTime: 1704153600000 },\r\n // ... more candles\r\n];\r\n\r\nconst pineTS = new PineTS(candles);\r\n\r\nconst { plots } = await pineTS.run(`\r\n//@version=6\r\nindicator(\"Custom Data\")\r\nplot(ta.sma(close, 10))\r\n`);\r\n```\r\n\r\n\r\n\r\n## API Coverage\r\n\r\nPineTS aims for complete Pine Script® API compatibility. See the [full coverage list](https://docs.luxalgo.com/developers/pinets/api-coverage). Current status:\r\n\r\n### Data & Context\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Technical Analysis & Math\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Data Structures\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Visualization\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Utilities\r\n\r\n\r\n\r\n\r\n\r\n> Click any badge to open the [API coverage](https://docs.luxalgo.com/developers/pinets/api-coverage) page\r\n\r\n\r\n\r\n## Documentation\r\n\r\nFull guides live at **[docs.luxalgo.com/developers/pinets](https://docs.luxalgo.com/developers/pinets)**.\r\n\r\n- [Getting Started](https://docs.luxalgo.com/developers/pinets/getting-started)\r\n- [Initialization and Usage](https://docs.luxalgo.com/developers/pinets/initialization-and-usage)\r\n- [Data Providers](https://docs.luxalgo.com/developers/pinets/data-providers)\r\n- [Pagination and Live Streaming](https://docs.luxalgo.com/developers/pinets/pagination)\r\n- [Architecture](https://docs.luxalgo.com/developers/pinets/architecture)\r\n- [API Coverage](https://docs.luxalgo.com/developers/pinets/api-coverage)\r\n\r\n\r\n\r\n## Charting with Vela\r\n\r\n[Vela](https://github.com/LuxAlgo/Vela) is LuxAlgo's open-source charting library. It ships no scripting engine of its own. [Vela PineTS](https://github.com/LuxAlgo/Vela-pinets) is the addon that runs Pine Script® `indicator()` and `strategy()` scripts on the chart, through Vela's public `ScriptingEngine` port, in-process (`PineEngine`) or off the main thread (`PineWorkerEngine`).\r\n\r\n\r\n ![\"Vela](\"./.github/images/vela.png\")
\r\n
\r\n![\"alaa-eddine\"](\"https://avatars.githubusercontent.com/u/1016513?v=4&s=64\" "\\"alaa-eddine\\"")
![\"dcaoyuan\"](\"https://avatars.githubusercontent.com/u/271571?v=4&s=64\" "\\"dcaoyuan\\"")
![\"C9Bad\"](\"https://avatars.githubusercontent.com/u/57975070?v=4&s=64\" "\\"C9Bad\\"")
![\"aakash-code\"](\"https://avatars.githubusercontent.com/u/71116743?v=4&s=64\" "\\"aakash-code\\"")
![\"alexgrover\"](\"https://avatars.githubusercontent.com/u/41912104?v=4&s=64\" "\\"alexgrover\\"")
![\"amoradi\"](\"https://avatars.githubusercontent.com/u/6855005?v=4&s=64\" "\\"amoradi\\"")
![\"smack369\"](\"https://avatars.githubusercontent.com/u/126825390?v=4&s=64\" "\\"smack369\\"")
![\"NexusAlien\"](\"https://avatars.githubusercontent.com/u/181855714?v=4&s=64\" "\\"NexusAlien\\"")
![\"yoonbae81\"](\"https://avatars.githubusercontent.com/u/20147594?v=4&s=64\" "\\"yoonbae81\\"")