pinets
v0.9.14
Published
Run Pine Script anywhere. PineTS is an open-source transpiler and runtime that brings Pine Script logic to Node.js and the browser with 1:1 syntax compatibility. Reliably write, port, and run indicators or strategies on your own infrastructure.
Downloads
3,411
Readme
What is PineTS?
PineTS is an open-source transpiler and runtime that seamlessly bridges Pine Script® and the JavaScript ecosystem. Develop your indicators once and deploy them everywhere: on your servers, in the browser, or fully integrated into your trading platforms.
import { PineTS, Provider } from 'pinets';
const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);
// Run native Pine Script® directly
const { plots } = await pineTS.run(`
//@version=5
indicator("EMA Cross")
plot(ta.ema(close, 9), "Fast", color.blue)
plot(ta.ema(close, 21), "Slow", color.red)
`);What is Pine Script®?
Pine Script® is a domain-specific programming language created by TradingView® for writing custom technical analysis indicators and strategies.
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.
⭐ If you find PineTS useful, please consider starring the repository to support the project!
Why PineTS?
| Challenge | PineTS Solution | | ------------------------------------------- | ---------------------------------------------------- | | Pine Script® only runs on TradingView® | Run indicators on your own infrastructure | | Can't integrate indicators with custom apps | Full JavaScript/TypeScript integration | | Limited to TradingView®'s data sources | Use any data source (Binance, custom APIs, CSV) | | No programmatic access to indicator values | Get raw values for backtesting, alerts, ML pipelines | | Can't run indicators server-side | Works in Node.js, Deno, Bun, browsers |
Quick Start
Installation
npm install pinetsHello World
import { PineTS, Provider } from 'pinets';
// Initialize with Binance data
const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1h', 100);
// Calculate a simple moving average
const { plots } = await pineTS.run(`
//@version=5
indicator("My First Indicator")
sma20 = ta.sma(close, 20)
plot(sma20, "SMA 20")
`);
console.log('SMA values:', plots['SMA 20'].data);That's it! You're running Pine Script® in JavaScript.
Features
Core Capabilities
- Native Pine Script® v5/v6 : Run original TradingView® code directly (experimental)
- 60+ Technical Indicators : SMA, EMA, RSI, MACD, Bollinger Bands, and more
- Time-Series Processing : Full Pine Script® semantics with lookback support
- Real-time Streaming : Live data processing with event-based updates
- Multi-Timeframe Analysis :
request.security()for MTF indicators - High Precision : Matches TradingView®'s calculation precision
Two Ways to Write Indicators
//@version=5
indicator("RSI Strategy")
rsi = ta.rsi(close, 14)
sma = ta.sma(rsi, 10)
plot(rsi, "RSI")
plot(sma, "Signal")//@PineTS
indicator('RSI Strategy');
const rsi = ta.rsi(close, 14);
const sma = ta.sma(rsi, 10);
plot(rsi, 'RSI');
plot(sma, 'Signal');Usage
Running Native Pine Script®
import { PineTS, Provider } from 'pinets';
const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', 'D', 200);
const { plots } = await pineTS.run(`
//@version=5
indicator("MACD", overlay=false)
[macdLine, signalLine, hist] = ta.macd(close, 12, 26, 9)
plot(macdLine, "MACD", color.blue)
plot(signalLine, "Signal", color.orange)
plot(hist, "Histogram", color.gray, style=plot.style_histogram)
`);
// Access the calculated values
console.log('MACD Line:', plots['MACD'].data);
console.log('Signal Line:', plots['Signal'].data);Using PineTS Syntax
import { PineTS, Provider } from 'pinets';
const pineTS = new PineTS(Provider.Binance, 'ETHUSDT', '4h', 100);
const { plots } = await pineTS.run(($) => {
const { close, high, low } = $.data;
const { ta, plot, plotchar } = $.pine;
// Calculate indicators
const ema9 = ta.ema(close, 9);
const ema21 = ta.ema(close, 21);
const atr = ta.atr(14);
// Detect crossovers
const bullish = ta.crossover(ema9, ema21);
const bearish = ta.crossunder(ema9, ema21);
// Plot results
plot(ema9, 'Fast EMA');
plot(ema21, 'Slow EMA');
plotchar(bullish, 'Buy Signal');
plotchar(bearish, 'Sell Signal');
return { ema9, ema21, atr, bullish, bearish };
});Real-time Streaming
import { PineTS, Provider } from 'pinets';
const pineTS = new PineTS(Provider.Binance, 'BTCUSDT', '1m');
const stream = pineTS.stream(
`
//@version=5
indicator("Live RSI")
plot(ta.rsi(close, 14), "RSI")
`,
{ live: true, interval: 1000 },
);
stream.on('data', (ctx) => {
const rsi = ctx.plots['RSI'].data.slice(-1)[0].value;
console.log(`RSI: ${rsi.toFixed(2)}`);
if (rsi < 30) console.log('Oversold!');
if (rsi > 70) console.log('Overbought!');
});
stream.on('error', (err) => console.error('Stream error:', err));Custom Data Source
import { PineTS } from 'pinets';
// Your own OHLCV data
const candles = [
{ open: 100, high: 105, low: 99, close: 103, volume: 1000, openTime: 1704067200000 },
{ open: 103, high: 108, low: 102, close: 107, volume: 1200, openTime: 1704153600000 },
// ... more candles
];
const pineTS = new PineTS(candles);
const { plots } = await pineTS.run(`
//@version=5
indicator("Custom Data")
plot(ta.sma(close, 10))
`);API Coverage
PineTS aims for complete Pine Script® API compatibility. Current status:
Data & Context
Technical Analysis & Math
Data Structures
Visualization
Utilities
Click any badge to see detailed function-level coverage
Documentation
- Full Documentation — Complete guides and API reference
- Initialization Guide — Setup options and configuration
- Architecture Overview — How PineTS works internally
- API Coverage Details — Function-by-function compatibility
Use Cases
Algorithmic Trading
- Build custom trading bots using Pine Script® strategies
- Integrate indicators with your execution systems
Backtesting
- Test Pine Script® strategies against historical data
- Export indicator values for analysis in Python/R
Alert Systems
- Create custom alert pipelines based on indicator signals
- Monitor multiple assets with server-side indicator calculations
Research & Analysis
- Process large datasets with Pine Script® indicators
- Feed indicator outputs into machine learning models
Custom Dashboards
- Embed live indicators in web applications
- Build real-time monitoring dashboards
Roadmap
| Status | Feature |
| ------ | ----------------------------------------- |
| ✅ | Native Pine Script® v5/v6 support |
| ✅ | 60+ technical analysis functions |
| ✅ | Arrays, matrices, and maps |
| ✅ | Real-time streaming |
| ✅ | Multi-timeframe with request.security() |
| 🚧 | Strategy backtesting engine |
| 🚧 | Additional data providers |
| 🎯 | Pine Script® v6 full compatibility |
| 🎯 | Market data Providers |
| 🎯 | Trading Connectors |
Contributing
Contributions are welcome! Whether it's:
- Adding missing Pine Script® functions
- Improving documentation
- Fixing bugs
- Suggesting features
Please feel free to open issues or submit pull requests.
Contributors
See CONTRIBUTING.md for the full guidelines.
Thanks to all PineTS contributors:
License
PineTS is dual-licensed:
AGPL-3.0 — Free for everyone. You can use PineTS for personal projects, research, and internal tools without any obligation. The copyleft terms only apply if you distribute your application to others or provide it as a network service (e.g., SaaS, public API) — in that case, your full source code must also be released under AGPL-3.0.
Commercial License — For companies and individuals who want to use PineTS in proprietary or closed-source software without AGPL-3.0 obligations. Contact us for licensing.
