Developers

Free API endpoints and embeddable widgets. No authentication required. Data refreshes every 12 hours.

Embeddable Risk Badge

Add a live currency risk score to your website, blog, or newsletter. The widget auto-updates and includes a backlink to the full analysis. Available in light and dark themes.

Light theme

Dark theme

Embed code

<!-- Fiat Risk Badge — replace USD with any currency code -->
<iframe
  src="https://fiatrisk.com/api/embed/USD"
  width="320"
  height="200"
  frameborder="0"
  style="border:none;border-radius:12px"
  title="Currency risk score"
></iframe>

<!-- Dark theme -->
<iframe
  src="https://fiatrisk.com/api/embed/USD?theme=dark"
  width="320"
  height="200"
  frameborder="0"
  style="border:none;border-radius:12px"
  title="Currency risk score"
></iframe>

Works with any currency code: USD, EUR, GBP, JPY, TRY, NGN, ARS, etc. See full list.

API Endpoints

All endpoints return JSON, require no authentication, and are cached with 1-12 hour revalidation. Rate limits are generous but please be respectful.

GET/api/trends

Historical indicator data (20-year series) for up to 8 countries.

Parameters

countries(string)— Comma-separated ISO alpha-2 codes (max 8)

Example

GET /api/trends?indicator=inflation&countries=US,GB,JP,TR,AR

Response

[
  {
    "alpha2": "US",
    "name": "United States",
    "data": [
      { "year": 2005, "value": 3.4 },
      { "year": 2006, "value": 3.2 },
      ...
    ]
  },
  ...
]

GET/api/historical-scores

Risk score trajectory for a single country over time. Uses monthly snapshots where available, falls back to computed scores from World Bank historical data.

Parameters

country(string)— ISO alpha-2 code

months(number)— Months of history (default 24)

Example

GET /api/historical-scores?country=TR&months=60

Response

[
  { "date": "2020", "score": 58, "riskLevel": "high" },
  { "date": "2021", "score": 65, "riskLevel": "high" },
  { "date": "2022", "score": 78, "riskLevel": "critical" },
  ...
]

GET/api/embed/{code}

Embeddable HTML widget showing a currency's current risk score. Designed for iframe embedding.

Parameters

code(string)— Currency code (e.g. USD, EUR, TRY)

theme(string)— light | dark (default: light)

Example

GET /api/embed/TRY?theme=dark

Response

Returns HTML document (Content-Type: text/html)

GET/api/health

Data quality and API health report. Shows which data sources are operational.

Example

GET /api/health

Response

{
  "status": "healthy",
  "total": 177,
  "withData": 165,
  "avgCompleteness": "62%",
  "apis": {
    "worldBank": "ok",
    "exchangeRates": "ok",
    "governance": "ok"
  }
}

For AI Agents

Fiat Risk is designed to be machine-readable. AI crawlers are welcomed in our robots.txt, and we provide structured metadata to help agents understand our data.

/llms.txt

Site overview, data model, API endpoints, and risk factor descriptions optimised for LLMs.

JSON-LD on every page

Each country and currency page includes Schema.org Dataset markup with risk scores, inflation rates, debt ratios, and other indicators as structured PropertyValues.

robots.txt

GPTBot, ClaudeBot, PerplexityBot, Cohere, and Google-Extended are all explicitly allowed.

Attribution

Fiat Risk data is free to use. If you use our data or embed our widgets, we appreciate a link back to fiatrisk.com. The embed widget includes attribution automatically.