Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Tenzro Labs Platform Forecasts API
version: 1.0.0
description: Browse the curated catalogue; manage credits, billing, keys, plans and rentals; place and pay orders; run Datasets, Fieldwork, Voices and Forecasts. Chat, embeddings, images, speech and the model list keep the OpenAI-compatible /v1 paths.
servers:
- url: https://api.tenzro.xyz
security:
- apiKey: []
tags:
- name: Forecasts
paths:
/forecasts:
post:
tags:
- Forecasts
summary: Forecast a time series
description: Needs a key with the `inference` permission.
operationId: postForecasts
x-tenzro-scope: inference
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- history
- horizon
properties:
model:
type: string
examples:
- timesfm-2.5-200m
history:
type: array
items:
type: number
minItems: 2
horizon:
type: integer
minimum: 1
quantiles:
type: array
items:
type: number
exclusiveMinimum: 0
exclusiveMaximum: 1
frequency_seconds:
type: integer
minimum: 1
machine:
type: string
description: 'Where to run the model. Default: tenzro-partner-cluster.'
responses:
'200':
description: The forecast
content:
application/json:
schema:
type: object
properties:
object:
const: forecast
model:
type: string
history_used:
type: integer
point:
type: array
items:
type: number
quantile_levels:
type: array
items:
type: number
quantiles:
type: array
items:
type: array
items:
type: number
generation_time_ms:
type:
- integer
- 'null'
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
scope:
type: string
description: 'On a 403: the permission the key lacks.'
securitySchemes:
apiKey:
type: http
scheme: bearer
description: A Tenzro Labs API key (tzl_…).
ingestKey:
type: http
scheme: bearer
description: 'A Fieldwork ingest key (tzi_…): bound to one project and the origins listed on it, able only to run the participant flow. Safe in a browser. Create it with POST /fieldwork/projects/{id}/ingest-keys.'
serviceAssertion:
type: http
scheme: bearer
bearerFormat: JWT
description: 'A Tenzro Labs service''s ES256 assertion: header kid = the RFC 7638 thumbprint of a key in the service''s published JWKS; iss = sub = the service; aud = this endpoint; exp at most 60 s after iat; jti used once.'