SDK lifecycle & generated clients
Move from the published API v2 contract into verified SDK packages or generated cURL, JavaScript, Python and PHP starters while keeping credentials, scopes and financial authority separate.
Contract lifecycle
228f3cf999f801d03634f0dad1fc6d296671bc13a8cf0d80994b00a57b62f910Integration tracks
export FINANCEGPT_API_KEY="your-sandbox-key"Fastest path for contract verification, generated starters and CI smoke calls.
export FINANCEGPT_API_KEY="your-sandbox-key"Use native fetch for direct API v2 calls, generate an operation starter, or download a published FinanceGPT JavaScript SDK.
export FINANCEGPT_API_KEY="your-sandbox-key"Use requests for direct API v2 calls, generate an operation starter, or download a published FinanceGPT Python SDK.
export FINANCEGPT_API_KEY="your-sandbox-key"Use the cURL extension for direct API v2 calls, generate an operation starter, or download a published FinanceGPT PHP SDK.
Onboarding checklist
- Create a least-privilege sandbox application in the Developer Console.
- Keep the credential outside source control and load it from an environment variable or secret manager.
- Use the API Explorer to validate the exact operation, path parameters, request body and required scope.
- Use the SDK lifecycle manifest to verify package fingerprints and explicit OpenAPI contract attestation status.
- Generate a cURL, JavaScript, Python or PHP starter for the exact operation without embedding credentials.
- Inspect workspace-scoped request latency and failures in Developer Observability before requesting production access.
- Request production access separately; application identity does not create model, policy or transaction authority.
Selected operation · Read portfolio front-to-back operating state
/investment/portfolios/{portfolio}/book/operations · investment:readcurl
curl -X GET \
-H "Authorization: Bearer $FINANCEGPT_API_KEY" \
-H "Accept: application/json"
"https://financegpt.dev/api/v2/investment/portfolios/{portfolio}/book/operations"javascript
const response = await fetch("https:\/\/financegpt.dev\/api\/v2\/investment\/portfolios\/{portfolio}\/book\/operations", {
method: "GET",
headers: {
Authorization: `Bearer ${FINANCEGPT_API_KEY}`,
Accept: 'application/json',
},
});
const data = await response.json();python
import json
import os
import requests
response = requests.request(
'GET',
'https://financegpt.dev/api/v2/investment/portfolios/{portfolio}/book/operations',
headers={
'Authorization': 'Bearer ' + os.environ['FINANCEGPT_API_KEY'],
'Accept': 'application/json',
},
)
response.raise_for_status()
print(response.json())php
<?php
$ch = curl_init('https://financegpt.dev/api/v2/investment/portfolios/{portfolio}/book/operations');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer '.getenv('FINANCEGPT_API_KEY'),
'Accept: application/json',
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Published SDK releases
| SDK | Version | Runtime | Package integrity | Contract attestation | Actions |
|---|---|---|---|---|---|
FinanceGPT JavaScript SDK33cbd6d47073742cd798942eaa4105c898df06961d39a073760dfab43ff8f5a4 | 0.1.0 | Node.js 18+ | verified | not attested | ManifestDownload ZIP |
FinanceGPT PHP SDKb34be3bc2b319954052112604b1237293453a7bc3a0be80257078a820de7bf4b | 0.1.0 | PHP 8.1+ | verified | not attested | ManifestDownload ZIP |
FinanceGPT Python SDK031137c08eec5c8ac95d53f1345e7087db37c4d009a0a7c9396de2b1baa37bc6 | 0.1.0 | Python 3.9+ | verified | not attested | ManifestDownload ZIP |
MCP quick start
POST https://financegpt.dev/api/mcp
Authorization: Bearer $FINANCEGPT_API_KEY
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/list