Market data snapshots · API reference

Query parameters

datasetstringoptional
Filter by dataset (optional): market_peers | transaction_deals.
statusstringoptional
Filter by status (optional): active | superseded.
limitintegeroptional
Maximum number of snapshots (default 50).

Response

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

snapshotsobject[]
Show child attributes
- idstring
- datasetstring · nullable
  market_peers | transaction_deals
- as_of_datestring · nullable
- provider_idstring · nullable
- modestring · nullable
  api | file
- statusstring · nullable
  active | superseded
- row_countnumber · nullable
- notesstring · nullable
- created_atstring · nullable
- updated_atstring · 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/list_market_snapshots" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/list_market_snapshots",
    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/list_market_snapshots", {
  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/list_market_snapshots",
        [Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "snapshots": [
    {
      "id": "9b0c1d2e-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
      "dataset": "market_peers",
      "as_of_date": "2025-12-31",
      "provider_id": "fmp",
      "mode": "api",
      "status": "active",
      "row_count": 6,
      "notes": "Panel logiciels industriels, clôture 31/12/2025.",
      "created_at": "2026-01-08T09:30:00Z",
      "updated_at": "2026-01-08T09:30:00Z"
    },
    {
      "id": "0c1d2e3f-4a5b-4c6d-9e7f-8a9b0c1d2e3f",
      "dataset": "transaction_deals",
      "as_of_date": "2025-12-31",
      "provider_id": "mergermarket",
      "mode": "file",
      "status": "active",
      "row_count": 14,
      "notes": "Transactions logiciel B2B Europe 2024-2025.",
      "created_at": "2026-01-10T11:00:00Z",
      "updated_at": "2026-01-10T11:00:00Z"
    }
  ]
}

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.