Quickstart

Get your first feature computed in under 5 minutes.

1 Get your API key

Request a free Demo key instantly. No credit card required.

content_copy

curl -X POST https://api.nodebar.dev/billing/demo-key \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

import requests

r = requests.post(
  "https://api.nodebar.dev/billing/demo-key",
  json={"email": "[email protected]"}
)
print(r.json())

const axios = require('axios');

const { data } = await axios.post(
  'https://api.nodebar.dev/billing/demo-key',
  { email: '[email protected]' }
);
console.log(data); // { api_key: 'nb_...' }

const res = await fetch('https://api.nodebar.dev/billing/demo-key', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: '[email protected]' })
});
const data = await res.json();
console.log(data); // { api_key: 'nb_...' }

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]string{"email": "[email protected]"})
  resp, _ := http.Post(
    "https://api.nodebar.dev/billing/demo-key",
    "application/json",
    bytes.NewBuffer(body),
  )
  defer resp.Body.Close()
  var result map[string]any
  json.NewDecoder(resp.Body).Decode(&result)
  fmt.Println(result)
}

using System.Net.Http;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
var payload = JsonSerializer.Serialize(new { email = "[email protected]" });
var content = new StringContent(payload, Encoding.UTF8, "application/json");
var resp = await client.PostAsync(
  "https://api.nodebar.dev/billing/demo-key", content);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.nodebar.dev/billing/demo-key"))
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"email\":\"[email protected]\"}"))
  .build();
var resp = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

Your key will arrive by email in seconds. To upgrade, visit the pricing page.

2 Make your first request

Compute daily log-returns for AAPL over 2024. Replace YOUR_API_KEY with your key.

content_copy

curl -X POST https://api.nodebar.dev/features/compute \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{

    "symbol": "AAPL",

    "timeframe": "1d",

    "start": "2024-01-01T00:00:00Z",

    "end": "2024-12-31T23:59:59Z",

    "features": [{"name": "returns", "params": {}}]

  }'

import requests


r = requests.post(

  "https://api.nodebar.dev/features/compute",

  headers={"X-API-Key": "YOUR_API_KEY"},

  json={

    "symbol": "AAPL",

    "timeframe": "1d",

    "start": "2024-01-01T00:00:00Z",

    "end": "2024-12-31T23:59:59Z",

    "features": [{"name": "returns", "params": {}}]

  }

)

data = r.json()

print(f"rows={data['rows']}, next_start={data['next_start']}")

const axios = require('axios');


const { data } = await axios.post(

  'https://api.nodebar.dev/features/compute',

  { symbol: 'AAPL', timeframe: '1d',

    start: '2024-01-01T00:00:00Z', end: '2024-12-31T23:59:59Z',

    features: [{ name: 'returns', params: {} }] },

  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }

                    );
console.log(`rows=${data.rows}, next_start=${data.next_start}`);

const res = await fetch('https://api.nodebar.dev/features/compute', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    symbol: 'AAPL', timeframe: '1d',
    start: '2024-01-01T00:00:00Z',
    end: '2024-12-31T23:59:59Z',
    features: [{ name: 'returns', params: {} }]
  })
});
const data = await res.json();
console.log(`rows=${data.rows}, next_start=${data.next_start}`);

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

func main() {
  payload := map[string]any{
    "symbol": "AAPL", "timeframe": "1d",
    "start": "2024-01-01T00:00:00Z",
    "end":   "2024-12-31T23:59:59Z",
    "features": []any{map[string]any{
      "name": "returns", "params": map[string]any{},
    }},
  }
  b, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST",
    "https://api.nodebar.dev/features/compute", bytes.NewBuffer(b))
  req.Header.Set("X-API-Key", "YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  var out map[string]any
  json.NewDecoder(resp.Body).Decode(&out)
  fmt.Println(out["rows"])
}

using System.Net.Http;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY");
var payload = new {
  symbol = "AAPL", timeframe = "1d",
  start = "2024-01-01T00:00:00Z",
  end = "2024-12-31T23:59:59Z",
  features = new[] { new { name = "returns", @params = new { } } }
};
var content = new StringContent(
  JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
var resp = await client.PostAsync(
  "https://api.nodebar.dev/features/compute", content);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
String json = """
    {"symbol":"AAPL","timeframe":"1d",
     "start":"2024-01-01T00:00:00Z",
     "end":"2024-12-31T23:59:59Z",
     "features":[{"name":"returns","params":{}}]}""";
var req = HttpRequest.newBuilder()
  .uri(URI.create("https://api.nodebar.dev/features/compute"))
  .header("X-API-Key", "YOUR_API_KEY")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString(json))
  .build();
var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

Response

{
  "rows": 252,
  "next_start": null,
  "data": [
    { "timestamp": "2024-01-02T00:00:00+00:00", "returns_log_close": null },
    { "timestamp": "2024-01-03T00:00:00+00:00", "returns_log_close": -0.00123 },
    ...
  ]
}

next_start is null here because 252 daily bars fit in one page. For 1m over long ranges it will contain the next page timestamp (see Pagination).

3 Compute multiple features at once

Pass several features in the same request. They come back as extra columns on the same timestamps.

content_copy

r = requests.post(

  "https://api.nodebar.dev/features/compute",

  headers={"X-API-Key": "YOUR_API_KEY"},

  json={

    "symbol": "AAPL", "timeframe": "1d",

    "start": "2020-01-01T00:00:00Z",

    "end": "2024-12-31T23:59:59Z",

    "features": [

      {"name": "returns",              "params": {}},

      {"name": "historical_volatility", "params": {"window": 30}},

      {"name": "rolling_mad",           "params": {"window": 20}}

    ]

  }

)

curl -X POST https://api.nodebar.dev/features/compute \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"symbol":"AAPL","timeframe":"1d","start":"2020-01-01T00:00:00Z","end":"2024-12-31T23:59:59Z","features":[{"name":"returns","params":{}},{"name":"historical_volatility","params":{"window":30}},{"name":"rolling_mad","params":{"window":20}}]}'

const axios = require('axios');

const { data } = await axios.post(
  'https://api.nodebar.dev/features/compute',
  {
    symbol: 'AAPL', timeframe: '1d',
    start: '2020-01-01T00:00:00Z',
    end: '2024-12-31T23:59:59Z',
    features: [
      { name: 'returns',              params: {} },
      { name: 'historical_volatility', params: { window: 30 } },
      { name: 'rolling_mad',           params: { window: 20 } }
    ]
  },
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
console.log(`rows=${data.rows}`);

const res = await fetch('https://api.nodebar.dev/features/compute', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    symbol: 'AAPL', timeframe: '1d',
    start: '2020-01-01T00:00:00Z',
    end: '2024-12-31T23:59:59Z',
    features: [
      { name: 'returns',              params: {} },
      { name: 'historical_volatility', params: { window: 30 } },
      { name: 'rolling_mad',           params: { window: 20 } }
    ]
  })
});
const data = await res.json();
console.log(`rows=${data.rows}`);

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

func main() {
  payload := map[string]any{
    "symbol": "AAPL", "timeframe": "1d",
    "start": "2020-01-01T00:00:00Z",
    "end":   "2024-12-31T23:59:59Z",
    "features": []any{
      map[string]any{"name": "returns",               "params": map[string]any{}},
      map[string]any{"name": "historical_volatility", "params": map[string]any{"window": 30}},
      map[string]any{"name": "rolling_mad",           "params": map[string]any{"window": 20}},
    },
  }
  b, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST",
    "https://api.nodebar.dev/features/compute", bytes.NewBuffer(b))
  req.Header.Set("X-API-Key", "YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  var out map[string]any
  json.NewDecoder(resp.Body).Decode(&out)
  fmt.Println(out["rows"])
}

using System.Net.Http;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY");
var payload = new {
  symbol = "AAPL", timeframe = "1d",
  start = "2020-01-01T00:00:00Z",
  end = "2024-12-31T23:59:59Z",
  features = new object[] {
    new { name = "returns",               @params = new { } },
    new { name = "historical_volatility", @params = new { window = 30 } },
    new { name = "rolling_mad",           @params = new { window = 20 } }
  }
};
var content = new StringContent(
  JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
var resp = await client.PostAsync(
  "https://api.nodebar.dev/features/compute", content);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
String json = """
    {"symbol":"AAPL","timeframe":"1d",
     "start":"2020-01-01T00:00:00Z",
     "end":"2024-12-31T23:59:59Z",
     "features":[
       {"name":"returns","params":{}},
       {"name":"historical_volatility","params":{"window":30}},
       {"name":"rolling_mad","params":{"window":20}}
     ]}""";
var req = HttpRequest.newBuilder()
  .uri(URI.create("https://api.nodebar.dev/features/compute"))
  .header("X-API-Key", "YOUR_API_KEY")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString(json))
  .build();
var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

Next steps

pages

Pagination

Fetch years of 1m data with next_start.

key

Authentication

Best practices for keeping your key secure.