Developer API

Scores over JSON, free with an account

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 (free — any account can) and send it as a Bearer token. Keys are org-scoped, and you can revoke one at any time.

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 — it is free, any account can — 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.

Does the API cost anything?

No. The site, the REST API and the MCP server are free; a key only needs an account. Paid plans are switched off, and if they ever return, existing keys keep working under whatever the free allowance is then.

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? Create a free account — the key is free. Questions: admin@quantamentry.com.

The API and the pipeline behind it are built by Arshad Ansari at Hikmah Technologies. How it is built →