TimesinkDB Documentation

TimesinkDB is a high-performance, direct-to-NVMe cloud time-series database built for serverless applications, automated webhook ingestion, and live customer portal charts. Zero DDL schemas, zero per-write transaction fees, and hardware-accelerated SIMD downsampling.

5-Minute Quickstart: Zero to Live Visual Chart

Follow these 4 simple steps to push your first metric, run hardware-accelerated downsampled queries, and embed a live customer-facing chart widget into your frontend—without provisioning binary drivers, schemas, or connection poolers.

1

Obtain Your Database Credentials & Verify Node

Every TimesinkDB database operates as an isolated physical partition with dedicated NVMe storage and compute workers. To interact with the API, you need three values:

Database ID 42 Numeric partition identifier
API Secret Key sec_live_9a7f2... Bearer token with write/read scopes
Regional Endpoint fra1.timesinkdb.com Nearest low-latency host node
Verify Node Liveness
curl -i https://fra1.timesinkdb.com/ping
Prelaunch Early Access Provisioning:

During the prelaunch phase, databases and API keys are provisioned immediately upon joining the waitlist or by emailing support@timesinkdb.com with your preferred region (fra1 Frankfurt, iad1 Virginia, or nrt1 Tokyo). Automated 1-click self-serve web management launches with general commercial availability in October 2026.

2

Push Your First Metric Point

Send any valid JSON payload via POST /databases/{databaseId}/series/{seriesKey}. Nested JSON properties automatically flatten into queryable columnar streams:

curl -X POST https://fra1.timesinkdb.com/databases/42/series/saas.tenant_42.api_calls \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{"req_per_min": 1420, "error_rate": 0.02, "p99_latency_ms": 48.5}'
Response (202 Accepted): 48 bytes committed to high-speed memory in <1ms. Zero per-write API fees.
3

Query Downsampled Metrics on the Fly

Query aggregated statistics across any time range with zero pre-computed rollups. Hardware-accelerated SIMD downsampling computes averages, maximums, and counts across raw points in single-digit milliseconds:

curl -X POST https://fra1.timesinkdb.com/databases/42/query \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "range": { "from": "-24h", "to": "now" },
    "interval": "15m",
    "queries": [
      { "id": "p99_perf", "seriesKey": "saas.tenant_42.api_calls.p99_latency_ms", "fn": "avg" }
    ]
  }'
4

Embed an Interactive Customer Chart

Generate a scoped read-only token (tok_ro_...) on your backend, then drop a turnkey interactive chart into your frontend portal using standard HTML. Zero frontend charting libraries required and $0 in egress fees:

<iframe
  src="https://fra1.timesinkdb.com/databases/42/series/saas.tenant_42.api_calls.html?from=-24h&interval=15m&theme=dark&token=tok_ro_..."
  class="w-full h-48 rounded-xl border border-neutral-800">
</iframe>

Where to Go Next