Invoke Governed QLM

Invoke an active FinanceGPT QLM with optional governed quantitative model runs.

Version: v2

Stability: stable

Sandbox: Available

Production: Entitlement required

Target latency: ≤ 1,200 ms

POST/api/v2/qlms/{uid}/invoke

M26 tool calls are proposals only. Invocations preserve hashes and operating metadata without storing raw prompts or responses in the QLM audit ledger.

Required scope: qlm:invoke

Try it in the FinanceGPT sandbox

The playground uses deterministic isolated sandbox fixtures. It never queries production workspace data and does not require you to paste an API secret into the browser.

Example response

{
    "data": {
        "invocation_uid": "00000000-0000-4000-8000-000000000026",
        "content": "...",
        "tool_proposals": [],
        "financial_action_executed": false
    }
}

Code examples

curl

curl -X POST \
  https://financegpt.dev/api/v2/qlms/00000000-0000-4000-8000-000000000026/invoke \
  -H "Authorization: Bearer $FINANCEGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Stress our portfolio for a 150bp rate shock.","quant_runs":[]}'

python

import os, requests

url = "https://financegpt.dev/api/v2/qlms/00000000-0000-4000-8000-000000000026/invoke"
headers = {"Authorization": f"Bearer {os.environ['FINANCEGPT_API_KEY']}"}
payload = {
    "prompt": "Stress our portfolio for a 150bp rate shock.",
    "quant_runs": []
}
response = requests.request("POST", url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

javascript

const response = await fetch('https://financegpt.dev/api/v2/qlms/00000000-0000-4000-8000-000000000026/invoke', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.FINANCEGPT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"prompt":"Stress our portfolio for a 150bp rate shock.","quant_runs":[]})
});
if (!response.ok) throw new Error(`FinanceGPT ${response.status}`);
console.log(await response.json());

php

<?php
$ch = curl_init('https://financegpt.dev/api/v2/qlms/00000000-0000-4000-8000-000000000026/invoke');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => ['Authorization: Bearer '.getenv('FINANCEGPT_API_KEY'), 'Content-Type: application/json'], CURLOPT_POSTFIELDS => '{\"prompt\":\"Stress our portfolio for a 150bp rate shock.\",\"quant_runs\":[]}']);
$response = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) >= 400) throw new RuntimeException($response);
echo $response;

Versions & changelog

v2 published

M26 publication of this governed FinanceGPT API operation.

Ready to build?

Explorer gives immediate isolated sandbox access. Production plans require a commercial entitlement.

Create account