Stabilarity API Gateway
Unified programmatic access to all research platform APIs
v1.1.0
Free Access for Stabilarity Researchers
The Stabilarity API Gateway is not a commercial product — it is research infrastructure provided free of charge to all community members.
Every researcher gets a personal API key automatically upon joining. Your key gives you access to all exposed research APIs including Geopolitical Risk data, ScanLab Medical AI, HPF Portfolio Optimizer, Research Articles, and AI Tools.
Join the community — get your free API key
The Stabilarity API Gateway is not a commercial product — it is research infrastructure provided free of charge to all community members.
Every researcher gets a personal API key automatically upon joining. Your key gives you access to all exposed research APIs including Geopolitical Risk data, ScanLab Medical AI, HPF Portfolio Optimizer, Research Articles, and AI Tools.
Join the community — get your free API key
Your Personal API Key
Your API Key
Already a member? Sign in
Already a member? Sign in
Quick Start
Base URL:
Auth:
Rate Limit: 100 requests/minute (researcher) | 100/day (demo key)
Format: JSON (charts return PNG images)
https://hub.stabilarity.com/api/v1/Auth:
X-API-Key header (or ?api_key= param)Rate Limit: 100 requests/minute (researcher) | 100/day (demo key)
Format: JSON (charts return PNG images)
# Check gateway status
curl -H “X-API-Key: YOUR_KEY” https://hub.stabilarity.com/api/v1/status
# Get country risk data
curl -H “X-API-Key: YOUR_KEY” https://hub.stabilarity.com/api/v1/geo-risk/data/countries
# List research articles
curl -H “X-API-Key: YOUR_KEY” https://hub.stabilarity.com/api/v1/research/articles?limit=5
# Classify an AI use case
curl -X POST -H “X-API-Key: YOUR_KEY” -H “Content-Type: application/json” \
-d ‘{“use_case”:”fraud detection”,”industry”:”finance”}’ \
https://hub.stabilarity.com/api/v1/tools/classify
# Get UIB benchmark leaderboard
curl -H “X-API-Key: YOUR_KEY” https://hub.stabilarity.com/api/v1/uib/leaderboard
# Analyze reference trustworthiness
curl -X POST -H “X-API-Key: YOUR_KEY” -H “Content-Type: application/json” \
-d ‘{“url”:”https://doi.org/10.1038/sdata.2016.18″}’ \
https://hub.stabilarity.com/api/v1/ref-trust-analyze
API Reference
Gateway Status
GET
/v1/status
Returns gateway health and all backend service statuses. No authentication required for basic health check.
// Response will appear here
Geopolitical Risk API
Real-time geopolitical risk analysis with country scores, macro indicators, and chart visualizations.
GET
/v1/geo-risk/status
Check health of the Geo Risk backend.
GET
/v1/geo-risk/data/countries
Returns geopolitical risk scores for all tracked countries.
GET
/v1/geo-risk/chart/{chart_type}
Returns a PNG chart. Types: timeseries, heatmap, world-map, forecast-comparison, regional-radar, top-stable, correlation-matrix, anomaly, region-bars.
GET
/v1/geo-risk/macro/current
Current macroeconomic indicators for risk assessment.
ScanLab Medical AI
Medical AI diagnostics with multiple models for image classification and analysis.
GET
/v1/scanlab/health
ScanLab backend health check.
GET
/v1/scanlab/models
List available diagnostic models.
POST
/v1/scanlab/predict
Submit data for medical AI prediction. See /v1/scanlab/models for inputs.
GET
/v1/scanlab/analytics
Usage analytics and model performance statistics.
HPF — Holistic Portfolio Framework
Portfolio optimization and risk analysis using the HPF methodology.
GET
/v1/hpf/health
HPF backend health check.
GET
/v1/hpf/sample
Sample portfolio with example allocations and risk metrics.
POST
/v1/hpf/analyze
Submit portfolio data for HPF analysis and optimization.
Research Articles API
Access published research articles from the Stabilarity platform with DOI metadata and category filtering.
GET
/v1/research/articles?category=&limit=20&offset=0
Paginated list of published research articles. Filter by category slug.
| Parameter | Type | Description |
|---|---|---|
| category | string | Filter by category slug (e.g. future-of-ai, ai-economics) |
| limit | int | Number of results (1-100, default 20) |
| offset | int | Pagination offset (default 0) |
GET
/v1/research/series
List all research series (categories) with article counts.
GET
/v1/research/articles/{post_id}
Full metadata for a single article including abstract.
AI Tools API
Programmatic access to Stabilarity AI assessment tools: use case classifier, ROI calculator, and risk assessment.
POST
/v1/tools/classify
AI Use Case Classifier. Input: {“use_case”: “…”, “industry”: “…”}. Returns category, fit score, recommendation, AADA score.
POST
/v1/tools/roi
ROI Calculator. Input: {“investment”: 100000, “team_size”: 5, “industry”: “finance”, “use_case”: “fraud detection”}. Returns ROI %, payback months, risk level.
POST
/v1/tools/risk
Risk Calculator. Input: {“industry”: “healthcare”, “data_quality”: 7, “team_size”: 10, “timeline_months”: 6}. Returns risk score, level, and contributing factors.
Example: Classify a Use Case
curl -X POST -H “X-API-Key: YOUR_KEY” -H “Content-Type: application/json” \
-d ‘{“use_case”:”customer churn prediction”,”industry”:”telecom”}’ \
https://hub.stabilarity.com/api/v1/tools/classify
// Response:
{
“category”: “Predictive Analytics”,
“fit_score”: 92,
“recommendation”: “Strong fit for Predictive Analytics in telecom. Recommend immediate pilot.”,
“aada_score”: 78
}
Universal Intelligence Benchmark (UIB)
Eight-dimensional AI benchmark framework. Run benchmarks against any model via API, view leaderboards, and retrieve detailed scoring reports.
GET
/v1/uib/status
UIB service status — total runs and models evaluated.
POST
/v1/uib/run
Run the full UIB benchmark against a model. Provide your own model API key. 8 dimensions: causal, embodied, multimodal, temporal, social, tool_creation, transfer, efficiency.
GET
/v1/uib/leaderboard?limit=20&benchmark_type=uib
Current leaderboard ranked by composite score. Filter by benchmark_type.
GET
/v1/uib/results?limit=50&offset=0
Paginated list of all benchmark results.
GET
/v1/uib/reports/{run_id}
Full detail for a single benchmark run by run_id.
GET
/v1/uib/dimensions
List all 8 UIB dimensions with task counts and descriptions.
Example: Run a Benchmark
curl -X POST -H “X-API-Key: YOUR_KEY” -H “Content-Type: application/json” \
-d ‘{“model”:”gpt-4″,”api_key”:”YOUR_MODEL_KEY”,”dimensions”:[“causal”,”social”]}’ \
https://hub.stabilarity.com/api/v1/uib/run
Reference Trust Analyzer
Evaluate the trustworthiness of academic references — DOI verification, source classification, and STABIL badge scoring.
POST
/v1/ref-trust-analyze
Analyze a URL for reference trustworthiness. Returns source type classification, DOI status, domain credibility, and badge-relevant metrics.
| Parameter | Type | Description |
|---|---|---|
| url | string | URL of the article or reference to analyze |
Example
curl -X POST -H “X-API-Key: YOUR_KEY” -H “Content-Type: application/json” \
-d ‘{“url”:”https://doi.org/10.1038/sdata.2016.18″}’ \
https://hub.stabilarity.com/api/v1/ref-trust-analyze
Interactive API Documentation
Full OpenAPI specification with try-it-out functionality. Enter your API key below to authenticate requests.
Authentication
API Key Authentication
All endpoints require authentication. Include your key in one of:
Rate limits: 100 req/min for researcher keys, 100 req/day for demo keys.
All endpoints require authentication. Include your key in one of:
X-API-Key: your-key-here (header, recommended)?api_key=your-key-here (query parameter)Rate limits: 100 req/min for researcher keys, 100 req/day for demo keys.
Your Personal API Key
Your API Key
Already a member? Sign in
Already a member? Sign in