API Reference

Generated directly from openapi/kuvola-api-v1.yaml. All requests require Authorization: Bearer <key>.

Available now

GET/api/v2/marketsList every regulated market on file

GET/api/v2/stocksList listed companies

GET/api/v2/bondsList corporate bonds and treasury/government securities

GET/api/v2/fxLatest FX rates, or a full history for one currency pair

GET/api/v2/macroCurrent macroeconomic indicators, or a full history for one indicator code

GET/api/v2/reportsThe calling organization's generated report history

GET/api/v2/pricesThe 5 most recent stored price observations for one instrument

GET/api/v2/historyThe full stored price/yield observation series for one instrument

GET/api/v2/yieldsA stored yield-curve snapshot for a country and date

GET/api/v1/datasetsList published, entitled datasets

GET/api/v1/datasets/{id}Get a single published dataset, including its version history

GET/api/v1/indicatorsList macroeconomic indicator observations

GET/api/v1/signalsList institutional signals (Phase 5.2)

GET/api/v1/intelligenceTop-level market intelligence summary

GET/api/v1/alertsList institutional alerts (Phase 5.2)

GET/api/v1/correlationsPairwise cross-asset correlation matrix

GET/api/v1/regimesCurrent rule-based market-regime classification

GET/api/v1/timelineChronological feed of signals, alerts, events, and dataset publications

GET/api/v1/organizations/meGet the calling API key's own organization profile and entitlement

GET/api/v1/usageGet the calling organization's API usage for the last 30 days

GET/api/researchList published research reports

GET/api/research/latestMost recently published research reports

GET/api/research/searchSearch published research (title, summary, type, country, asset class)

GET/api/research/{slug}A single published report's full content

GET/api/research/categoriesEditorial category taxonomy

GET/api/research/countriesCountries with at least one published report

GET/api/research/authorsPublic author bylines

GET/api/research/exportExport a published report (markdown, json, or a print-ready PDF redirect)

GET/api/dashboard/searchUnified workspace search

GET/api/dashboard/admin/connectorsList every registered ingestion connector with live status

POST/api/dashboard/admin/connectors/{connectorId}/runManually trigger one connector's ingestion run

GET/api/dashboard/admin/connectors/healthLive reachability probe for every connector's endpoint

POST/api/dashboard/admin/data-sources/importManually import a CSV/Excel/PDF file into the Data Platform

PUT/api/dashboard/admin/data-exchange/{datasetId}Update a dataset's KDX catalog metadata

POST/api/dashboard/admin/data-exchange/{datasetId}/publishPublish a dataset as a live KDX product

POST/api/dashboard/admin/data-exchange/{datasetId}/retireRetire a KDX product

PUT/api/dashboard/admin/licensing/{datasetId}Create or update a dataset's license record

GET/api/dashboard/admin/providersList every provider (Module 4 — Provider Management)

POST/api/dashboard/admin/providersCreate a provider

PUT/api/dashboard/admin/providers/{id}Update a provider's relationship and agreement status

GET/api/dashboard/admin/api-productsList every API product (Module 2 — API Product Catalog)

POST/api/dashboard/admin/api-productsCreate an API product

PUT/api/dashboard/admin/api-products/{id}Update an API product's pricing, SLA target and status

POST/api/dashboard/admin/api-products/{id}/changelogAdd a changelog entry to an API product

GET/api/dashboard/admin/subscriptionsList every dataset and API product access request (Module 5 / 10)

POST/api/dashboard/admin/subscriptions/dataset/{id}/decideApprove, reject or revoke a dataset access request

POST/api/dashboard/admin/subscriptions/api-product/{id}/decideApprove, reject or revoke an API product access request

GET/api/dashboard/admin/incidentsList platform incidents and maintenance windows (Module 7 — SLA & Monitoring)

POST/api/dashboard/admin/incidentsReport an incident or maintenance window

PUT/api/dashboard/admin/incidents/{id}Update or resolve an incident

PUT/api/dashboard/admin/organizations/{id}/onboardingApprove, reject or suspend an organization's onboarding status

GET/api/dashboard/organizations/{id}/api-keysList an organization's API keys (masked)

POST/api/dashboard/organizations/{id}/api-keysIssue a new API key

DELETE/api/dashboard/organizations/{id}/api-keys/{keyId}Revoke an API key

POST/api/dashboard/organizations/{id}/api-keys/{keyId}/rotateRotate an API key

GET/api/dashboard/organizations/{id}/api-keys/{keyId}/usageGet a single key's usage statistics

GET/api/dashboard/intelligence/executive-dashboardExecutive Intelligence Dashboard

POST/api/dashboard/intelligence/decision-assistantExplain an indicator, company, bond, FX movement, signal, alert, research report, or relationship

POST/api/dashboard/intelligence/research-workspaceAsk a natural-language research question (sector performance, yield comparison, market movement, entity announcements, indicator lookup)

GET/api/dashboard/intelligence/executive-briefList previously generated executive briefs

POST/api/dashboard/intelligence/executive-briefGenerate an Executive Brief

POST/api/dashboard/intelligence/portfolio-analysisEstimate a watchlist's macro exposure

GET/api/dashboard/intelligence/knowledge-graphGet an entity's real relationship graph

POST/api/dashboard/intelligence/research-copilotSuggest a report structure and sourcing candidates

GET/api/dashboard/intelligence/scenariosList an organization's scenarios

POST/api/dashboard/intelligence/scenariosCreate a scenario

PUT/api/dashboard/intelligence/scenarios/{id}Update a scenario's assumptions

DELETE/api/dashboard/intelligence/scenarios/{id}Soft-delete a scenario

POST/api/dashboard/intelligence/scenarios/{id}/runRun a scenario

GET/api/dashboard/intelligence/governanceList every AI output's provenance record

GET/api/dashboard/intelligence/reports/generateGenerate an executive report (PDF, Word, or PowerPoint)

GET/api/developer/sdk/{language}Download a generated SDK starter file for one language

Planned

Schema and RLS policy already exist; the route handler has not been built yet.

GET/api/v1/bondsList sovereign and corporate bonds

GET/api/v1/stocksList listed equities

GET/api/v1/treasuriesList treasury bill / money-market instruments

GET/api/v1/banksList central and commercial banks

GET/api/v1/newsList curated market news