Economic Indicators API

← All financial data endpoints

Why Use FinanceFlowAPI’s Economic Indicators API?

Pulling macroeconomic data usually means integrating a different national statistics agency, central bank or supranational database for every country you cover, each with its own format, naming and access rules. The Economic Indicators API normalizes 663 indicators across 131 countries into one schema and one authentication method, so you can add a new country or a new indicator to your product without a new integration.

• One JSON schema for every country and every indicator, so there's no per-source parsing.
• 663 unique indicators verified live against production, from headline metrics (GDP, CPI, unemployment) to dozens of sector- and category-specific series.
• A dedicated catalog endpoint to discover the exact indicator names available for any country, instead of guessing spellings.
• Same account, API key and billing as the rest of FinanceFlowAPI: Bonds, Commodities, Currency and Economic Calendar data.

Key Capabilities

• Latest + previous value per indicator: every response includes both the newest reported reading and the one before it, so you can see direction of change without a second call.
• Query by country, or by country + specific indicator: get everything available for a country, or narrow down to exactly the series you need (e.g. just GDP).
• Built-in discovery: world-indicators-catalog lists every indicator name available per country, for one country or for all 131 at once.
• Consistent units & reporting period: each value ships with its units and the report_date period it refers to.

Data Coverage & Trust

Example indicator categories available per country: GDP & GDP growth breakdowns, Consumer Price Index & inflation, unemployment & employment, interest & deposit rates, balance of trade, government debt & budget, consumer & business confidence, housing & construction, and hundreds more. The exact list varies by country and is always available live via the catalog endpoint below.

Data Methodology

Economic Indicators API data is aggregated from public and licensed macroeconomic data sources and normalized into one consistent schema (indicator_name, last, previous, units, report_date) for every supported country, so your integration doesn’t need a different parser per source. Publication cadence is set by the underlying source and varies by indicator, not by FinanceFlowAPI: most series update monthly or quarterly as new official readings are released. Sourced from aggregated third-party market and statistical data providers; the specific vendor and full per-indicator methodology are not published.

Live API Playground

An interactive API Playground for this endpoint is planned. Until it ships, use the request and response examples below, or your own HTTP client, to try the API live with your key.

Request Example

GET https://financeflowapi.com/api/v1/world-indicators?api_key=YOUR_API_KEY&country=United%20States&indicator_name=GDP

Response Example

{
  "success": true,
  "code": 200,
  "message": "OK",
  "meta": {
    "timestamp": 1787475716,
    "request_id": "6a8ab7048da62"
  },
  "data": [
    {
      "country": "United States",
      "indicator_name": "GDP",
      "last": "30770000000000.0",
      "previous": "29298000000000.0",
      "units": "USD",
      "report_date": "2025-12"
    }
  ]
}

API Parameters

world-indicators: indicator values for a country:

world-indicators-catalog: discover available indicator names:

Response Schema

world-indicators: each item in data:

world-indicators-catalog: each item in data:

HTTP Status & Errors

Code Examples

curl "https://financeflowapi.com/api/v1/world-indicators?api_key=YOUR_API_KEY&country=United%20States&indicator_name=GDP"

import requests

url = "https://financeflowapi.com/api/v1/world-indicators"
params = {
    "api_key": "YOUR_API_KEY",
    "country": "United States",
    "indicator_name": "GDP"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
  country: "United States",
  indicator_name: "GDP"
});

fetch(`https://financeflowapi.com/api/v1/world-indicators?${params}`)
  .then(res => res.json())
  .then(data => console.log(data));

<?php
$params = http_build_query([
    'api_key'        => 'YOUR_API_KEY',
    'country'        => 'United States',
    'indicator_name' => 'GDP',
]);

$response = file_get_contents("https://financeflowapi.com/api/v1/world-indicators?{$params}");
$data = json_decode($response, true);

print_r($data);

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY")
    params.Add("country", "United States")
    params.Add("indicator_name", "GDP")

    resp, err := http.Get("https://financeflowapi.com/api/v1/world-indicators?" + params.Encode())
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    var data map[string]interface{}
    json.Unmarshal(body, &data)

    fmt.Println(data)
}

Use Cases

• Macro dashboards & research. Build country or regional dashboards mixing GDP, inflation and unemployment without integrating a separate statistics agency for every market you cover.
• Correlate macro data with markets. Combine indicator readings with Bonds API and Economic Calendar API data to study how yields and scheduled releases react to underlying economic conditions.
• Screening & alerting. Power a screening or alerting tool keyed on indicator_name and country to flag notable prints, like an inflation reading that moves sharply from its previous value.

Who Is This API For?

• Quant researchers and analysts building macro models across multiple countries
• Fintech apps and dashboards that need country-level economic context alongside market data
• Publishers and content platforms that need sourced GDP, inflation and unemployment figures
• Developers building screening or alerting tools around economic data releases

Limitations

• No historical time series: each call returns only the latest and previous reported value per indicator, not a date range.
• indicator_name must match the catalog spelling exactly; there is no free-text or fuzzy search.
• Endpoint access and your per-minute rate limit depend on your subscription plan.
• Update cadence follows each indicator’s own publication schedule, not a fixed FinanceFlowAPI refresh SLA.

Related APIs

• Economic Calendar API: see the scheduled releases behind these indicator updates.
• Government Bonds API: see how bond yields relate to GDP, inflation and interest rate data.

Full API documentation →