Projects and public discovery

Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation.

API reference overview · OpenAPI download

Operations on this page#

Inspect a supported project using public market sources without a login, vault or payment#

POST /public/projects/resolve

Operation ID: resolvePublicProject

Authentication: No authentication is required by this operation’s contract.

Bounded public read with no private tenant lookup or issuer ownership assertion. A successful response may be partial and explicitly retains gaps. Observing a pool does not establish graduation, locked liquidity, issuer control or tradability. No saved investigation, entitlement, payment or financial authority is created.

This operation declares no parameters.

Request body#

Required: yes.

application/json

PublicProjectResolveRequest

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

413 response headers

413 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Inspect one bounded public reserve-scale liquidity question without a login or payment#

POST /public/projects/investigate

Operation ID: investigatePublicProjectLiquidity

Authentication: No authentication is required by this operation’s contract.

Reads the same public project evidence as project resolution and returns a source-backed VIRTUAL pool reserve-scale finding. This is not a tradability claim, executable quote, slippage estimate, custody instruction, paid job, saved tenant investigation, or financial authority. An unavailable finding preserves the source and explains its evidence gap.

This operation declares no parameters.

Request body#

Required: yes.

application/json

PublicLiquidityInvestigationRequest

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

413 response headers

413 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

List saved public-project bookmarks in the current workspace#

GET /projects

Operation ID: listSavedProjects

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Save an independently resolved public-project observation#

POST /projects

Operation ID: savePublicProject

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Request body#

Required: yes.

application/json

PublicProjectResolveRequest

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

409 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Read a saved public-project bookmark and its latest observation#

GET /projects/{projectId}

Operation ID: getSavedProject

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Append a newly resolved public observation to the exact saved project version#

POST /projects/{projectId}/refresh

Operation ID: refreshSavedProject

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Request body#

Required: yes.

application/json

object — Max properties: 0; Additional properties rejected

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

409 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

412 response headers

412 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

428 response headers

428 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

List immutable observation metadata without changing captured evidence#

GET /projects/{projectId}/observations

Operation ID: listSavedProjectObservations

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Read the exact immutable public observation version#

GET /projects/{projectId}/observations/{version}

Operation ID: getSavedProjectObservation

Authentication: __Host-klineo_session cookie (sessionCookie)

Requires current interactive workspace membership. Developer service credentials are not accepted. A saved public-project bookmark grants no issuer ownership, treasury access, paid entitlement, financial permission or publication authority. Observations are immutable public snapshots; refreshing appends a new version without rewriting history.

Parameters#

Responses#

200 response headers

200 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

400 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

401 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

403 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

404 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

429 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

503 application/json body

object — Additional properties rejected

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.