GraphiQuestor REST API

Institutional Macro Intelligence

270+ macro metrics. Time-series history. Regime signals and proprietary composite scores — with full methodology and provenance for every data point.

Authentication

http

Authorization: Bearer YOUR_API_KEY

API keys are available via the API Access page.

Free tier: 100 requests/day · Institutional tier: [email protected]

Base URL

url

https://graphiquestor.com/api/v1

All endpoints are HTTPS-only. Responses are JSON with UTF-8 encoding.

Endpoints

GET/api/v1/metrics

List all available metrics with latest values, staleness status, and metadata.

Name	Type	Required	Description
country	string	optional	ISO 3166-1 alpha-2 code (e.g. IN, US, CN)
category	string	optional	Metric category — monetary, fiscal, external, activity
limit	integer	optional	Number of results. Default 50, max 270

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/metrics?country=IN"

json

{
  "data": [
    {
      "metric_id": "india_rbi_rate",
      "label": "RBI Policy Rate",
      "value": 6.50,
      "unit": "%",
      "as_of": "2026-06-03T00:00:00Z",
      "staleness": "fresh",
      "source": "Reserve Bank of India",
      "methodology_url": "/methods/india-credit-cycle-clock"
    }
  ],
  "total": 42,
  "country": "IN"
}

GET/api/v1/observations

Time-series history for a specific metric. Up to 5 years of daily observations.

Name	Type	Required	Description
metric_id	string	required	Metric identifier from the /metrics endpoint
from	date	optional	ISO 8601 start date. Default: 90 days ago
to	date	optional	ISO 8601 end date. Default: today
limit	integer	optional	Max rows. Default 90, max 730

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/observations?metric_id=india_rbi_rate&from=2025-01-01"

json

{
  "metric_id": "india_rbi_rate",
  "label": "RBI Policy Rate",
  "unit": "%",
  "observations": [
    { "date": "2026-06-03", "value": 6.50 },
    { "date": "2026-05-01", "value": 6.50 },
    { "date": "2026-04-01", "value": 6.75 }
  ]
}

GET/api/v1/regime/current

Current macro regime signal — GraphiQuestor's proprietary daily composite across five structural pillars.

Note

No parameters required. Updated daily at 06:30 UTC using the prior day's close data. ◆ GQ SIGNAL indicates GQ-proprietary composite methodology. See /methods/regime-scoring.

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/regime/current"

json

{
  "regime_label": "Neutral",
  "regime_score": 55,
  "confidence_interval": 0.66,
  "score_delta": 2.3,
  "signal_components": {
    "volatility": 82,
    "rates": 40,
    "dollar": 34,
    "metals": 47,
    "liquidity": 70
  },
  "as_of": "2026-06-03T06:30:00Z",
  "methodology_url": "/methods/regime-scoring"
}

GET/api/v1/composite-scores

All GraphiQuestor proprietary composite scores in a single call — net liquidity, India macro, de-dollarization, and G20 sovereign stress.

Note

All scores in this endpoint carry the ◆ GQ SIGNAL designation. Methodology for each composite is linked in the full API response.

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/composite-scores"

json

{
  "scores": {
    "gq_net_liquidity_zscore": {
      "value": 0.82,
      "label": "Net Liquidity Z-Score",
      "regime": "Expanding",
      "as_of": "2026-06-03T00:00:00Z"
    },
    "india_macro_composite": {
      "value": 67,
      "label": "India Macro Score",
      "regime": "Expansion",
      "as_of": "2026-06-03T00:00:00Z"
    },
    "gq_dedollarization_index": {
      "value": 42.1,
      "label": "De-Dollarization Index",
      "direction": "accelerating",
      "as_of": "2026-06-03T00:00:00Z"
    },
    "g20_sovereign_stress_avg": {
      "value": 61.4,
      "label": "G20 Sovereign Stress",
      "regime": "Elevated",
      "as_of": "2026-06-03T00:00:00Z"
    }
  }
}

GET/api/v1/india/summary

Complete India macro snapshot in one call — optimized for dashboard integration and reduced round-trips.

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/india/summary"

json

{
  "as_of": "2026-06-03T00:00:00Z",
  "macro_score": 67,
  "regime": "Expansion",
  "metrics": {
    "india_rbi_rate":           { "value": 6.50, "unit": "%" },
    "india_cpi_yoy":            { "value": 4.31, "unit": "%" },
    "india_gdp_yoy":            { "value": 7.20, "unit": "%" },
    "india_fx_reserves_usd_bn": { "value": 665.4, "unit": "USD bn" },
    "india_cd_ratio":           { "value": 80.2, "unit": "%" },
    "india_mfg_pmi":            { "value": 58.1, "unit": "index" },
    "india_gst_collections":    { "value": 1.92, "unit": "₹ tn" },
    "india_inr_usd":            { "value": 83.4, "unit": "INR/USD" }
  },
  "credit_cycle_regime": "Downturn",
  "rbi_intervention_posture": "Neutral"
}

GET/api/v1/events

Upcoming and recent macro events — FOMC, RBI MPC, G20 summits, and scheduled data releases with impact classification.

Name	Type	Required	Description
from	date	optional	Start date. Default: today
to	date	optional	End date. Default: 30 days ahead
type	string	optional	Filter by type — FOMC, RBI_MPC, DATA_RELEASE, G20

bash

curl -H "Authorization: Bearer $GQ_API_KEY" \
  "https://graphiquestor.com/api/v1/events?from=2026-06-01&type=FOMC"

json

{
  "events": [
    {
      "id": "fomc_2026_06_11",
      "type": "FOMC",
      "title": "FOMC Rate Decision",
      "date": "2026-06-11T18:00:00Z",
      "impact": "high",
      "consensus": "hold",
      "prior": "4.50%",
      "market_implied_move": "±0.8%"
    }
  ],
  "total": 1
}

Metric ID Reference

Use these IDs in the metric_id parameter. Showing 40 of 40 metrics.

Metric ID	Label	Source
india_rbi_rate	RBI Policy Rate	Reserve Bank of India
india_cpi_yoy	India CPI YoY	MOSPI / FRED
india_gdp_yoy	India GDP Growth YoY	World Bank
india_fx_reserves_usd_bn	India FX Reserves (USD bn)	RBI DBIE
india_cd_ratio	Credit-Deposit Ratio	RBI
india_mfg_pmi	India Manufacturing PMI	S&P Global
india_gst_collections	GST Collections (₹ tn)	Ministry of Finance
india_inr_usd	INR/USD Exchange Rate	RBI / Alpha Vantage
india_10y_yield	India 10Y G-Sec Yield	RBI
india_fiscal_deficit_gdp	Fiscal Deficit (% GDP)	CGA / RBI
india_macro_composite	India Macro Score	GQ Proprietary
india_vix	India VIX	NSE
us_fed_funds_rate	Fed Funds Rate	FRED / Federal Reserve
us_cpi_yoy	US CPI YoY	BLS / FRED
us_10y_yield	US 10Y Treasury Yield	FRED
us_m2_yoy	US M2 Money Supply YoY	FRED
us_dxy_index	DXY Dollar Index	Alpha Vantage
global_net_liquidity	Global Net Liquidity	GQ Composite
gq_net_liquidity_zscore	Net Liquidity Z-Score	GQ Proprietary
gq_dedollarization_index	De-Dollarization Index	GQ Proprietary
g20_sovereign_stress_avg	G20 Sovereign Stress	GQ Composite
china_pmi_mfg	China Manufacturing PMI	NBS
china_fx_reserves_usd_bn	China FX Reserves (USD bn)	SAFE
gold_spot_usd	Gold Spot Price (USD)	Alpha Vantage
brent_crude_usd	Brent Crude Oil (USD)	EIA
PMI_US_MFG	US Manufacturing PMI	ISM / S&P Global
PMI_US_SERVICES	US Services PMI	ISM / S&P Global
INFLATION_HEADLINE_YOY	Headline Inflation (YoY %)	BLS / FRED
INFLATION_CORE_YOY	Core Inflation (YoY %)	BLS / FRED
INFLATION_BREAKEVEN_5Y	5Y Breakeven Inflation (%)	FRED
LABOR_UNEMPLOYMENT_RATE	Unemployment Rate (%)	BLS / FRED
LABOR_WAGE_GROWTH_YOY	Wage Growth (YoY %)	BLS / FRED
LABOR_VACANCIES_JOLTS	Job Vacancies (JOLTS)	BLS / FRED
CAPITAL_FROM_TREASURIES_BN	Capital from Treasuries (bn USD)	GQ Composite
CAPITAL_FROM_GOLD_ETF_BN	Capital from Gold ETFs (bn USD)	GQ Composite
BOP_CURRENT_ACCOUNT_GDP	Current Account (% GDP)	World Bank
BOP_RESERVES_MONTHS	FX Reserves (months import cover)	World Bank
HOUSING_PRICE_INDEX	Housing Price Index	S&P Case-Shiller
HOUSING_MORTGAGE_RATE_30Y	30Y Mortgage Rate (%)	FRED
ACTIVITY_REGIME_SCORE	Activity Regime Score	GQ Composite

Use Cases

Embed in your platform

Every GQ component supports ?embed=true for chromeless iframe embedding. White-label available for institutional partners.

html

<!-- GraphiQuestor Regime Signal — embeddable widget -->
<iframe
  src="https://graphiquestor.com/embed/regime?embed=true"
  width="100%"
  height="320"
  frameborder="0"
  style="border-radius:12px;background:transparent"
  allow="fullscreen"
  title="GraphiQuestor Macro Regime Signal"
></iframe>

Replace /embed/regime with any page path. White-label domain aliasing available for institutional partners — contact us.

White-label integration

GraphiQuestor's India Macro Terminal and De-Dollarization Lab are available for white-label embedding in institutional research platforms, Bloomberg portals, and fund manager dashboards. Custom branding, domain aliasing, and SSO available.

Contact: [email protected]

AI agent integration (MCP)

The graphiquestor/macro-intelligence MCP server mirrors these REST endpoints as typed tools for Cursor, Claude Desktop, and Smithery. Every response includes institutional commentary and dashboard deep links.

bash

# Smithery one-command install (Cursor)
npx -y @smithery/cli@latest mcp add graphiquestor/macro-intelligence --client cursor

# Smithery MCP URL (remote)
# https://macro-intelligence--graphiquestor.run.tools

# Local build (from repo mcp/graphiquestor/)
npm install && npm run build
export SUPABASE_URL="..." SUPABASE_ANON_KEY="..."
node dist/index.js

Tools: get_regime_current, get_composite_scores, get_india_summary, and 5 more. Full MCP protocol →

Data science / quant integration

Pull the India macro snapshot directly into Python for quant analysis or model inputs.

python

import requests
import pandas as pd

GQ_API_KEY = "YOUR_API_KEY"
BASE = "https://graphiquestor.com/api/v1"

headers = {"Authorization": f"Bearer {GQ_API_KEY}"}

# Fetch India macro snapshot
r = requests.get(f"{BASE}/india/summary", headers=headers)
data = r.json()

print(f"Regime: {data['regime']}  |  Score: {data['macro_score']}")
metrics = pd.DataFrame(data["metrics"]).T
print(metrics)

Rate Limits

Tier	Requests / day	History	Composite Scores
Free	100	90 days	✓
Institutional	Unlimited	5 years	✓

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Burst allowance: up to 20 requests/minute on Free, 200/minute on Institutional.

For institutional access or custom arrangements: [email protected]

Ready to integrate?

Get your API key and start pulling institutional macro data in minutes.

Get API Key →