Timestral API reference

curl -sS https://timestral.org/api/forecast \
  -H "Authorization: Bearer $TIMESTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "csv": "date,sales\n2026-01-01,120\n2026-01-02,135\n2026-01-03,128\n2026-01-04,141\n2026-01-05,150\n2026-01-06,162\n2026-01-07,155\n2026-01-08,168\n",
    "steps": 6
  }'

import os
import requests

csv_text = open("timestral-sample.csv", "r", encoding="utf-8").read()

response = requests.post(
    "https://timestral.org/api/forecast",
    headers={
        "Authorization": f"Bearer {os.environ['TIMESTRAL_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"csv": csv_text, "steps": 12},
    timeout=120,
)
response.raise_for_status()
payload = response.json()

if payload["code"] != 0:
    raise RuntimeError(payload["message"])

result = payload["data"]
print(result["taskId"], result["took"])
for row in result["rows"][:5]:
    print(row["time"], row["median"], row["low"], row["high"])
print("quantile CSV:", result.get("fileUrl"))

const apiKey = process.env.TIMESTRAL_API_KEY;

const response = await fetch("https://timestral.org/api/forecast", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    csv: await Bun.file("timestral-sample.csv").text(),
    steps: 12,
  }),
});

const payload = await response.json();
if (payload.code !== 0) throw new Error(payload.message);

const { taskId, rows, took, fileUrl } = payload.data;
console.log(taskId, took, rows.length, fileUrl);

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "f0c2…",
    "columns": ["sales"],
    "rows": [
      {
        "time": "2026-01-09",
        "column": "sales",
        "low": 151.2,
        "median": 164.8,
        "high": 178.1
      }
    ],
    "took": "3.42 s",
    "fileUrl": "https://timestral.org/api/media/uploads/forecast-….csv"
  }
}