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.
Ingest Stripe, GitHub, Shopify, and Clerk webhooks with zero glue code and edge HMAC validation.
1-line HTML and SVG chart embeds with scoped read-only tokens and fair-use $0 egress.
Protect PostgreSQL from connection pool exhaustion and eliminate intermediate Redis caches.
Complete endpoints specification, RFC 7807 error catalog, and live wire request simulator.
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.
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:
curl -i https://fra1.timesinkdb.com/ping
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.
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}'
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" }
]
}'
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
Capture Stripe MRR, GitHub CI, and Shopify orders with zero glue code.
Visual Customer Embeds →Learn how to whitelabel charts and drop iframe widgets into React and Retool.
Serverless Offloading →Protect PostgreSQL and MySQL from serverless connection pool exhaustion.
REST API Reference →Read canonical endpoint schemas, regional base URLs, and RFC 7807 error codes.
Interactive API Simulator →Simulate HTTP ingest and downsampling queries directly in your browser.
Pricing & Spend Caps →Explore Free Sandbox, Starter, Pro, and Scale capacity pooling tiers.