# NodeBar

> REST API delivering 348 precomputed quantitative features for financial analysis. One endpoint, ML-ready outputs, zero infrastructure.

## What it does

NodeBar computes financial indicators on OHLCV market data. You send a symbol, timeframe, date range and list of features. It returns computed series aligned to timestamps. No data pipelines, no local infrastructure needed.

## API Endpoint

POST https://api.nodebar.dev/features/compute

## Authentication

Add header: X-API-Key: YOUR_API_KEY
Get a free Demo key at: https://nodebar.dev/pricing

## Quick Example

```json
POST /features/compute
{
  "symbol": "AAPL",
  "timeframe": "1d",
  "start": "2024-01-01T00:00:00Z",
  "end": "2025-01-01T00:00:00Z",
  "features": [
    {"name": "rsi", "params": {"window": 14}},
    {"name": "macd", "params": {}},
    {"name": "bollinger_bands", "params": {"window": 20}}
  ]
}
```

Response contains `rows`, `next_start` (for pagination), and `data` array with computed columns.

## Feature Categories (348 total)

- Technical Analysis (200): RSI, MACD, Stochastic, Bollinger, ATR, ADX, Ichimoku, VWAP, OBV, candlestick patterns, market structure, composite scores, and more
- Anomaly Detection (4): price_anomaly, volume_anomaly, volatility_anomaly, combined_anomaly_score
- Statistical (67): returns, volatility, distribution, risk/tails, cross-asset, regime detection, spectral/fractal
- ML & Normalization (6): zscore, rolling_rank, pca_scores, signature_features, feature_lags, return_histograms
- Macro Economics (37): GDP, CPI, unemployment, liquidity, trade, housing, cross-macro composites, normalization
- Fundamentals (35, BETA): valuation, earnings, quality, growth, balance-sheet ratios

## Key Parameters

- symbol: ticker (AAPL, EUR/USD, BTC/USD) or ISO country code for macro (US, DE, GB)
- timeframe: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w (also 1M, 3M, 1Y for macro)
- start/end: ISO 8601 timestamps
- features: array of {name, params} objects
- response_format: "json" (default), "csv", or "parquet"

## Output Types

Every feature returns enriched outputs beyond raw values:
- value (float): the computed indicator
- _zscore (float): how unusual vs recent history
- _percentile (float 0-1): rank across time
- _state (Int8): discrete regime -1/0/1
- _signal (Int8): directional intent
- _event (Int8): discrete triggers (crossovers, breakouts)

## Plans

- Demo (free): 307 features (LIGHT tier), 100 credits/day, 2y history
- Basic ($39/mo): 336 features (LIGHT + MEDIUM), 20,000 credits/day, intraday, 10y history
- Pro ($89/mo): all 348 features (LIGHT + MEDIUM + HEAVY), 200,000 credits/day, unlimited history

## Credits

1 credit = 1 feature per request, regardless of rows returned.
Credits reset daily at midnight UTC.

## Links

- Documentation: https://nodebar.dev/docs
- Full API reference: https://nodebar.dev/docs/api/features-compute
- Feature catalog: https://nodebar.dev/docs/features-catalog
- Symbol catalog: https://nodebar.dev/docs/symbols
- Playground: https://nodebar.dev/playground
- Pricing: https://nodebar.dev/pricing
- Full technical docs for AI: https://nodebar.dev/llms-full.txt