Developer API

Scores over JSON, on every plan

Daily credibility scores, seven-dimension breakdowns, 90-day history and macro indicators for 169emerging & frontier markets — the same data the dashboard renders, as clean JSON.

Authentication

Create an API key on your account page (any active plan, including the trial) and send it as a Bearer token. Keys are org-scoped: if your subscription lapses they stop working, and start again when you restart it.

curl -H "Authorization: Bearer qm_YOUR_KEY" \
  https://www.quantamentry.com/api/v1/scores/TUR

Endpoints

`GET /api/v1/scores` ?benchmark=true\|false	All countries: composite score, 7/30-day deltas, coverage, freshness.
`GET /api/v1/scores/{iso}`	One country in full: seven dimensions, executive summary, peer context, provenance.
`GET /api/v1/scores/{iso}/history` ?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD	Daily composite history (90 days by default).
`GET /api/v1/macro/{iso}`	All macro indicators for one country (derived/clean-licence series only).
`GET /api/v1/carry`	Real-rate carry screen: policy rate minus inflation in basis points, ranked, with an FX-volatility adjustment and full exclusion accounting.
`GET /api/v1/nowcast`	CPI nowcast: next month's inflation forecast for each country, made before the print and graded after, with a scorecard against a naive benchmark. Where the CPI source is restricted, the print and our forecast level are withheld and the forecast's change from the last print ships instead.
`GET /api/v1/calendar`	Central-bank calendar: next decision date (cited to each bank's own calendar), stance change between the last two meetings, and the Taylor surprise in percentage points.
`GET /api/v1/countries`	Country metadata: names, regions, central banks, coverage tier.

Rate limit: 60 requests/min per key. Responses are JSON; errors use { "error": "..." } with conventional status codes (401 bad key, 403 revoked key or lapsed subscription, 429 rate-limited). Scores refresh daily; history is point-in-time. Raw single-source BIS/IMF series are not exposed — derived and clean-licence indicators only.

MCP server

The same data is exposed as a read-only Model Context Protocol server at /api/mcp (streamable HTTP, JSON-RPC 2.0) — six tools covering scores, rankings, history, coverage, methodology and country comparison. Authenticate with the same Bearer key:

{
  "mcpServers": {
    "quantamentry": {
      "type": "http",
      "url": "https://www.quantamentry.com/api/mcp",
      "headers": { "Authorization": "Bearer qm_YOUR_KEY" }
    }
  }
}

Free tier. The same endpoint answers without a key, with three teaser tools instead of six: list_countries (rank, country, region and credibility band — no scores), get_country(one country's composite score, band, regional rank, 7-day move, one-line read and score date) and get_latest_briefing. That is exactly what the public website shows; the seven dimensions, the executive summary, the 90-day history and the 30-day deltas need a key. Free calls are limited to 30 requests/min per IP.

API questions

How do I authenticate?

Create an API key on your account page — any active plan, the trial included — and send it as a Bearer token in the Authorization header. Keys are org-scoped, stored hashed, and you can hold up to five active at once and revoke any of them.

What are the rate limits?

60 requests a minute per key on the REST endpoints and the keyed MCP server. The free, unauthenticated MCP tier is 30 requests a minute per IP. Over the limit you get HTTP 429; scores refresh once a day, so caching a response for an hour costs you nothing.

What happens when my subscription lapses?

The keys stop working — they answer HTTP 403 rather than being deleted — and they start working again the moment the subscription restarts. Nothing is lost in between and you do not have to re-issue a key.

Which data is not available over the API?

Raw single-source BIS and IMF series. The API serves derived indicators and clean-licence sources only, which is the same gate the website itself runs under. The v1 endpoints are country-level: scores, history, macro indicators and country metadata. The dashboard's global-context and coverage views have no v1 equivalent.

No key yet? Start a 15-day free trial — API access is included in every plan. Questions: admin@quantamentry.com.