Positions by instrument (LP) · API reference

Query parameters

company_iduuidoptional
Company UUID (optional).
fund_iduuidoptional
Fund UUID (optional).

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

positionsobject[]
Show child attributes
- company_idstring · nullable
- labelstring · nullable
- kindstring · nullable
- currencystring · nullable
- quantitynumber · nullable
- cost_basis_eurnumber · nullable
- fair_value_eurnumber · nullable
- fair_value_sourceenum · nullable
  One of: published
- fair_value_as_ofstring · nullable
- provision_pctnumber · nullable
- ifrs_levelstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.

Request

cURL

curl "https://jolv-mcp.vercel.app/v1/get_lp_positions" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_lp_positions",
    headers={"Authorization": f"Bearer {os.environ['JOLV_TOKEN']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

JavaScript

const r = await fetch("https://jolv-mcp.vercel.app/v1/get_lp_positions", {
  headers: { Authorization: `Bearer ${process.env.JOLV_TOKEN}` },
});
if (!r.ok) throw new Error((await r.json()).error.message);
const data = await r.json();

Power Query

let
    Source = Json.Document(Web.Contents(
        "https://jolv-mcp.vercel.app/v1/get_lp_positions",
        [Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "positions": [
    {
      "company_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "label": "Nordlicht Software – preferred shares",
      "kind": "preferred_shares",
      "currency": "EUR",
      "quantity": 120000,
      "cost_basis_eur": 12000000,
      "fair_value_eur": 11200000,
      "fair_value_source": "published",
      "fair_value_as_of": "2025-12-31",
      "provision_pct": 0,
      "ifrs_level": "3"
    },
    {
      "company_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "label": "Nordlicht Software – ordinary shares",
      "kind": "ordinary_shares",
      "currency": "EUR",
      "quantity": 330000,
      "cost_basis_eur": 3300000,
      "fair_value_eur": 2660000,
      "fair_value_source": "published",
      "fair_value_as_of": "2025-12-31",
      "provision_pct": 0,
      "ifrs_level": "3"
    }
  ]
}

Try it

or paste a token below

The call goes from your browser to the API with your own token; nothing is stored. Token kept in this tab only.