# Klineo documentation > Public documentation for Klineo Liquidity Studio, API v2 (contract 2.0.0), and TypeScript/Python SDKs 2.1.0. ## Get started - [Introduction](https://docs.klineo.io/get-started/introduction/index.md): Build integrations for token liquidity research, deterministic simulations, and reviewed operating decisions with KlineO Liquidity Studio. - [Quickstart](https://docs.klineo.io/get-started/quickstart/index.md): Make your first authorized request, then optionally persist a deterministic sandbox study. This walkthrough works with either SDK and requires an API environment and organization a - [Installation](https://docs.klineo.io/get-started/installation/index.md): Install the SDK source into your application, then configure the API URL, organization, and credential for your environment. npm and PyPI publication are separate release steps; th ## Platform - [Platform overview](https://docs.klineo.io/platform/overview/index.md): Klineo brings public market observations, issuer planning, deterministic studies, human review, liquidity operations, and verification into one evidence workflow. Treasury teams ca - [Architecture](https://docs.klineo.io/platform/architecture/index.md): Klineo separates the interface, API authorization, deterministic calculation, evidence storage, and onchain custody. Each layer has a defined responsibility so that a screen, model - [Data lineage](https://docs.klineo.io/platform/data-lineage/index.md): Data lineage connects a displayed result to the sources, versions, assumptions, calculation, and human actions that produced it. Klineo preserves that connection so a later refresh ## SDKs - [Klineo SDKs](https://docs.klineo.io/sdks/overview/index.md): Use the TypeScript or Python client to integrate with the Klineo Liquidity Operating System v2. Both provide generated request and response types, scoped authentication, exact reso - [TypeScript & JavaScript](https://docs.klineo.io/sdks/typescript/index.md): TypeScript and JavaScript ESM client for the KlineO Liquidity Operating System v2 API. The generated client includes every operation in the v2 OpenAPI contract and exports named re - [Python](https://docs.klineo.io/sdks/python/index.md): Typed Python client for the Klineo Liquidity Operating System v2 API. Python 3.11 or newer is required. The SDK uses the Python standard library and has no runtime dependencies. ## Developers - [Authentication](https://docs.klineo.io/developers/authentication/index.md): Use an organization-bound API key or OAuth client credentials for backend integrations. Interactive browser sessions support the app's reviewed, role-controlled workflows. Service - [Scopes and permissions](https://docs.klineo.io/developers/scopes/index.md): Every service credential has an explicit scope grant. The route must accept service authentication, the credential must hold the required scope, and its creator must still have org - [API overview](https://docs.klineo.io/developers/api-overview/index.md): Klineo’s v2 API connects project discovery, issuer planning, deterministic studies, treasury records, proposal review and verifiable evidence. Its base path is /api/liquidity-studi - [Errors and retries](https://docs.klineo.io/developers/errors/index.md): Use the HTTP status and stable error code to decide what to do next. Preserve the correlation ID when reporting a failed request, and keep the original idempotency key when retryin - [Idempotency and concurrency](https://docs.klineo.io/developers/idempotency/index.md): A lost HTTP response does not tell you whether a mutation committed. Give each mutation intent a durable idempotency key and retain it while recovering an uncertain result. Retry t - [Webhooks](https://docs.klineo.io/developers/webhooks/index.md): Receive signed notifications when organization records or their events change. Webhooks let your integration maintain a local view without repeatedly polling every resource. A webh ## Mechanics - [Liquidity mechanics](https://docs.klineo.io/mechanics/liquidity/index.md): Klineo turns a project's liquidity objectives into capital comparisons, simulation evidence, bounded proposals, and recorded outcomes. Planning and analysis can help a team review - [Simulation and stress testing](https://docs.klineo.io/mechanics/simulation/index.md): Klineo provides two different simulation surfaces: Digital Twin studies compare modeled capital plans across deterministic paths; liquidity replay evaluates a strategy against an o - [Decisions and execution](https://docs.klineo.io/mechanics/decisions/index.md): Klineo separates private decision review from custody-changing proposals. A Decision Pack records evidence and a human decision. An executable proposal binds a specific vault actio ## Guides - [Workspaces, access and roles](https://docs.klineo.io/guides/workspace/index.md): A workspace is an organization-scoped environment for saved project evidence, research, decisions and eligible vault records. Authentication identifies the user; membership and ser - [Projects and saved observations](https://docs.klineo.io/guides/projects/index.md): Start with a public project when you want to understand a token's observable liquidity. A project bookmark keeps evidence for your workspace; operational vault setup follows a sepa - [Markets and data quality](https://docs.klineo.io/guides/markets/index.md): Use Markets to inspect where liquidity is observable and which evidence supports the displayed trading conditions. The connected application shows returned source records; the demo - [Vaults and issuer onboarding](https://docs.klineo.io/guides/vaults/index.md): A vault is an operating record for issuer-owned liquidity. The issuer Safe and active canonical policy provide authority. A saved public project, workspace membership or plan previ - [Treasury](https://docs.klineo.io/guides/treasury/index.md): Treasury brings ledger holdings, custody observations, obligations, conditional receipts, and cash-flow scenarios into one workspace. Use it to review where capital is recorded, in - [Capital planning](https://docs.klineo.io/guides/capital-planning/index.md): Capital planning translates an issuer's liquidity goals into a reproducible study. It estimates a minimum capital requirement, reserve requirement, range width, fee-income bounds, - [What-if Research](https://docs.klineo.io/guides/research/index.md): What-if Research translates a reviewed question and explicit assumptions into a bounded hypothetical experiment. Deterministic private studies produce the numeric outcomes; the mod - [AI agents](https://docs.klineo.io/guides/agents/index.md): Klineo agents produce evidence-backed investigations, saved-proposal reviews and hypothetical research. A durable agent run has a reviewed source, a bounded workflow, saved progres - [Research workflows](https://docs.klineo.io/guides/workflows/index.md): The AI Agent conversation helps you inspect a public project, compare its returned pools and ask questions about the evidence. With an authorized connected workspace, you can add a - [Public proof and Liquidity Passports](https://docs.klineo.io/guides/proof/index.md): Klineo lets an issuer disclose selected liquidity evidence outside its private workspace. A public outcome proof records a completed reporting period. A Liquidity Passport presents - [Reports and exports](https://docs.klineo.io/guides/reports/index.md): Klineo reports connect a vault's recorded outcomes to the evidence used to compute them. A report identifies its UTC period, immutable artifact, source coverage, benchmark assumpti - [Partner portfolios and consent](https://docs.klineo.io/guides/partners/index.md): Klineo's partner platform lets an authorized partner view a reduced portfolio of consenting issuers, prepare issuer-scoped proposals, and apply verified branding to eligible public ## Trust & security - [Security and trust](https://docs.klineo.io/trust/security/index.md): Klineo separates planning, application access, and onchain authority. An SDK can read permitted evidence and prepare supported workflows. It cannot turn an application role, API ke - [Permissions and credentials](https://docs.klineo.io/trust/permissions/index.md): Klineo evaluates three distinct permissions: access to an organization, permission to perform an application workflow, and authority to sign an onchain action. An organization role - [Contract architecture](https://docs.klineo.io/trust/contracts/index.md): Klineo's liquidity contracts implement issuer-owned vaults and bounded venue actions. The application and SDKs prepare, explain, and observe those actions; ownership, policy, and e ## Resources - [Roadmap and availability](https://docs.klineo.io/resources/roadmap/index.md): KlineO separates implementation, deployment evidence, and permission to operate. An API route, SDK method, or application screen can exist before a capability is enabled in your en - [Changelog](https://docs.klineo.io/resources/changelog/index.md): This changelog records the documented source baseline. A version number identifies a contract or package; it does not establish that a hosted deployment is live, that packages have - [Frequently asked questions](https://docs.klineo.io/resources/faq/index.md): KlineO helps teams study token liquidity, compare plans, review evidence, and prepare decisions around issuer liquidity and treasury workflows. The application combines public proj ## API reference - [API reference](https://docs.klineo.io/api-reference/overview/index.md): The committed KlineO Token Liquidity Operating System API 2.0.0 contract describes 238 operations across 189 paths. This reference is generated from that contract. - [Agent runs and research](https://docs.klineo.io/api-reference/agents/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Projects and public discovery](https://docs.klineo.io/api-reference/projects/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Platform, credentials and webhooks](https://docs.klineo.io/api-reference/platform/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Decision packs](https://docs.klineo.io/api-reference/decision-packs/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Treasury custody and project control](https://docs.klineo.io/api-reference/treasury-custody/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Treasury reconciliation](https://docs.klineo.io/api-reference/treasury-reconciliation/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Treasury assumptions](https://docs.klineo.io/api-reference/treasury-assumptions/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Treasury projections and summary](https://docs.klineo.io/api-reference/treasury-projections/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Other API resources](https://docs.klineo.io/api-reference/other/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Treasury ledger and capital planning](https://docs.klineo.io/api-reference/treasury-ledger/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Proposal review and Safe evidence](https://docs.klineo.io/api-reference/proposals/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Issuer intents, launches and unlocks](https://docs.klineo.io/api-reference/issuer-planning/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Simulation studies and sharing](https://docs.klineo.io/api-reference/simulation/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Strategies and packages](https://docs.klineo.io/api-reference/strategies/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Market quality, attribution and alerts](https://docs.klineo.io/api-reference/market-quality/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Venues, allocations and migrations](https://docs.klineo.io/api-reference/venues/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Autonomy policies and intent compilation](https://docs.klineo.io/api-reference/policies/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Protected execution planning](https://docs.klineo.io/api-reference/protected-execution/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Partners, consent and market makers](https://docs.klineo.io/api-reference/partners/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Incentive programs](https://docs.klineo.io/api-reference/incentives/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. - [Proof, vaults, receipts and passports](https://docs.klineo.io/api-reference/proof/index.md): Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation. ## API schemas - [API schemas](https://docs.klineo.io/api-reference/schemas/index.md): The 332 named schemas below come from the committed OpenAPI contract. Field paths expand inline objects and stop at linked named types. Required is evaluated inside its containing ## API v1 reference - [v1 · API reference](https://docs.klineo.io/api-reference/v1/overview/index.md): The committed KlineO Liquidity Studio API 1.0.0 contract describes 142 operations across 130 paths. This reference is generated from that contract. - [v1 · Platform, credentials and webhooks](https://docs.klineo.io/api-reference/v1/platform/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. - [v1 · Other API resources](https://docs.klineo.io/api-reference/v1/other/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. - [v1 · Venues, allocations and migrations](https://docs.klineo.io/api-reference/v1/venues/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. - [v1 · Proof, vaults, receipts and passports](https://docs.klineo.io/api-reference/v1/proof/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. - [v1 · Proposal review and Safe evidence](https://docs.klineo.io/api-reference/v1/proposals/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. - [v1 · Projects and public discovery](https://docs.klineo.io/api-reference/v1/projects/index.md): Paths on this page are relative to /api/liquidity-studio/v1. Authentication and required headers vary by operation. ## API v1 schemas - [v1 · API schemas](https://docs.klineo.io/api-reference/v1/schemas/index.md): The 36 named schemas below come from the committed OpenAPI contract. Field paths expand inline objects and stop at linked named types. Required is evaluated inside its containing o - [OpenAPI contract](https://docs.klineo.io/openapi/liquidity-operating-system-v2.openapi.json)