Research Experiment Runner

Run a governed feature-quality experiment against a sealed research snapshot.

Version: v2

Stability: stable

Sandbox: Available

Production: Entitlement required

Target latency: ≤ 1,800 ms

POST/api/v2/quant/research/runs

M17 executes governed analytical experiments only; arbitrary customer code execution remains disabled.

Required scope: quant:research:run

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": {
        "run_uid": "00000000-0000-4000-8000-000000000018",
        "status": "completed"
    }
}

Code examples

curl

curl -X POST \
  https://financegpt.dev/api/v2/quant/research/runs \
  -H "Authorization: Bearer $FINANCEGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"snapshot_id":1,"name":"Feature quality review"}'

python

import os, requests

url = "https://financegpt.dev/api/v2/quant/research/runs"
headers = {"Authorization": f"Bearer {os.environ['FINANCEGPT_API_KEY']}"}
payload = {
    "project_id": 1,
    "snapshot_id": 1,
    "name": "Feature quality review"
}
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/quant/research/runs', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.FINANCEGPT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"project_id":1,"snapshot_id":1,"name":"Feature quality review"})
});
if (!response.ok) throw new Error(`FinanceGPT ${response.status}`);
console.log(await response.json());

php

<?php
$ch = curl_init('https://financegpt.dev/api/v2/quant/research/runs');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => ['Authorization: Bearer '.getenv('FINANCEGPT_API_KEY'), 'Content-Type: application/json'], CURLOPT_POSTFIELDS => '{\"project_id\":1,\"snapshot_id\":1,\"name\":\"Feature quality review\"}']);
$response = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) >= 400) throw new RuntimeException($response);
echo $response;

Versions & changelog

v2 published

M17 publication of this governed FinanceGPT API operation.

Ready to build?

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

Create account