Home / API and Developers

API and Developers

Build with Eco Data Technologies data

A free, public JSON API for headline indicators, exchange rates, open datasets, publications and country data. No key needed to get started.

Get started See all endpoints

Overview

The Eco Data Technologies API gives you the same figures that power our dashboards: headline indicators, naira exchange rates, every open dataset, our latest publications and country data for more than 200 economies. It is free, read-only and returns JSON.

Base URLhttps://ecodatatechnologies.com/wp-json/ecodata/v1

No key neededSend a plain HTTPS GET request. Responses are cached for up to an hour.

Open licenceReuse the data under CC BY 4.0. Credit Eco Data Technologies.

Quick start

Request the headline indicators. Every response includes an attribution and licence field.

curl https://ecodatatechnologies.com/wp-json/ecodata/v1/indicators

const res = await fetch("https://ecodatatechnologies.com/wp-json/ecodata/v1/indicators");
const data = await res.json();

for (const i of data.indicators) {
  console.log(i.label, i.value, i.source);
}

import requests

data = requests.get("https://ecodatatechnologies.com/wp-json/ecodata/v1/indicators", timeout=30).json()

for i in data["indicators"]:
    print(i["label"], i["value"], i["source"])

Response

Request

curl https://ecodatatechnologies.com/wp-json/ecodata/v1/indicators

Response200 OK · application/json

{
    "country": "NGA",
    "indicators": [
        {
            "label": "Headline inflation (y/y)",
            "value": "14.63%",
            "source": "NBS · Sep 2026",
            "note": "▼ 0.76 pp vs Aug",
            "tone": "good"
        },
        {
            "label": "Monetary policy rate",
            "value": "23.00%",
            "source": "CBN MPC · 22 Sep 2026",
            "note": "Reset from 26.5%",
            "tone": "good"
  …

Request API access

The public endpoints are open: you can start now without registering. Request access if you need higher limits, bulk downloads, a dataset we do not publish yet, or an institutional arrangement. Tell us who you are, what you are building and the data and volumes you need.

Request access Email enquiries@ecodatatechnologies.com

Authentication

No authentication is needed for the public endpoints: send a plain HTTPS GET request. Every request is anonymous and read-only.

Authenticated access for institutional users, with personal keys and higher limits, will be introduced once the data infrastructure and licensing arrangements are ready. Organisations that request access now will be told how to authenticate when it opens.

Endpoints

All endpoints use GET and live under https://ecodatatechnologies.com/wp-json/ecodata/v1.

Indicator endpoints

Endpoint	What it returns
GET`/indicators`	Headline indicators shown on the homepage board: inflation, policy rate, GDP growth, the naira and the NGX index, with source and date. Try it →
GET`/rates`	Official naira rates against the ten most traded currencies (CBN NFEM for the US dollar, crosses for the rest) and the parallel market buy and sell rates. Try it →
GET`/ticker`	Every series in the market ticker, with its latest value, change and direction. Try it →

Dataset and publication endpoints

Endpoint	What it returns
GET`/datasets`	Catalogue of open datasets with links to JSON, CSV and Excel downloads. Parameters: search, page, per_page (max 100) Try it →
GET`/datasets/{slug}`	One dataset: column headings and rows. Add ?format=objects to get each row as an object keyed by heading. Parameters: format Try it →
GET`/publications`	Latest briefs and reports with title, type, date, summary and link. Parameters: per_page (max 50), category (slug) Try it →

Country endpoints

Endpoint	What it returns
GET`/countries`	Countries on the platform and their coverage status (live, next, planned). Try it →
GET`/country/{ISO3}`	Country profile from the World Bank and IMF: GDP, growth, inflation, population, trade, reserves and debt, as yearly series. Try it →
GET`/compare`	One indicator for up to eight countries side by side. Parameters: indicator, c (comma-separated ISO3 codes) Try it →
GET`/rank`	Every country ranked on one indicator for a given year. Parameters: indicator, year Try it →

Exchange rates

Official naira rates against the ten most traded currencies, plus the parallel market rate for the US dollar. The US dollar rate is the CBN NFEM closing rate; other currencies are indicative crosses.

Request

curl https://ecodatatechnologies.com/wp-json/ecodata/v1/rates

Response200 OK · application/json

{
    "base": "NGN",
    "as_of": "30 Oct 2026",
    "official": [
        {
            "code": "USD",
            "currency": "US dollar",
            "ngn": 1346.859999999999899955582804977893829345703125
        },
        {
            "code": "EUR",
            "currency": "Euro",
            "ngn": 1503.76999999999998181010596454143524169921875
        },
        {
            "code": "JPY",
            "currency": "Japanese yen",
            "ngn": 8.5099999999999997868371792719699442386627197265625
        },
        {
            "code": "GBP",
            "currency": "British pound",
  …

Dataset endpoints

Every table in the Data Hub is available as JSON, CSV and Excel. Use /datasets to list them, then fetch one by its slug.

/datasets?search=inflation&per_page=20&page=1 searches the catalogue.
/datasets/{slug} returns column headings and rows; add ?format=objects for one object per row.
Each entry links to its CSV (?download=csv) and Excel (?download=xlsx) files.

Request

curl https://ecodatatechnologies.com/wp-json/ecodata/v1/datasets/capital-importation-quarterly?format=objects

Response200 OK · application/json

{
    "slug": "capital-importation-quarterly",
    "title": "Capital importation into Nigeria, by quarter (US$ billion)",
    "summary": "Quarterly totals from the National Bureau of Statistics capital importation reports.",
    "updated": "2026-11-08T09:14:28+00:00",
    "columns": [
        "Quarter",
        "Capital imported (US$ billion)"
    ],
    "source": "National Bureau of Statistics, capital importation reports",
    "links": {
        "page": "https://ecodatatechnologies.com/data/capital-importation-quarterly/",
        "json": "https://ecodatatechnologies.com/wp-json/ecodata/v1/datasets/capital-importation-quarterly",
        "csv": "https://ecodatatechnologies.com/data/capital-importation-quarterly/?download=csv",
        "xlsx": "https://ecodatatechnologies.com/data/capital-importation-quarterly/?download=xlsx"
    },
    "data": [
        {
            "Quarter": "Q1 2025",
            "Capital imported (US$ billion)": "5.64"
        },
        {
            "Quarter": "Q2 2025",
            "Capital imported (US$ billion)": "5.12"
        },
        {
            "Quarter": "Q3 2025",
            "Capital imported (US$ billion)": "6.01"
        },
        {
  …

Country endpoints

Yearly indicators for more than 200 economies from the World Bank World Development Indicators and the IMF World Economic Outlook, refreshed weekly. Use ISO 3166 alpha-3 codes, for example NGA, GHA or KEN.

/country/NGA: the full profile for one country.
/compare?indicator=inflation&c=NGA,GHA,KEN: up to eight countries side by side.
/rank?indicator=gdp_growth&year=2024: every country ranked for one year.

Indicator codes

Code	Indicator
`gdp`	GDP (US$) · World Bank WDI
`gdp_growth`	GDP growth (%) · World Bank WDI
`gdp_pc`	GDP per capita (US$) · World Bank WDI
`inflation`	Inflation (consumer prices) (%) · World Bank WDI
`unemploy`	Unemployment (ILO estimate) (%) · World Bank WDI
`pop`	Population (people) · World Bank WDI
`urban`	Urban population (% of total) · World Bank WDI
`agri`	Agriculture (% of GDP) · World Bank WDI
`industry`	Industry (% of GDP) · World Bank WDI
`services`	Services (% of GDP) · World Bank WDI
`exports`	Exports of goods and services (US$) · World Bank WDI
`imports`	Imports of goods and services (US$) · World Bank WDI
`reserves`	Total reserves (incl. gold) (US$) · World Bank WDI
`fx`	Official exchange rate (per US$) (LCU per US$) · World Bank WDI
`debt_gdp`	Government gross debt (% of GDP) · IMF WEO
`ext_debt`	External debt stocks (US$) · World Bank WDI
`rev_gdp`	Government revenue (% of GDP) · IMF WEO
`exp_gdp`	Government expenditure (% of GDP) · IMF WEO
`tax_gdp`	Tax revenue (central government) (% of GDP) · World Bank WDI
`lending_rate`	Lending interest rate (%) · World Bank WDI
`real_rate`	Real interest rate (%) · World Bank WDI
`fdi_gdp`	Foreign direct investment, net inflows (% of GDP) · World Bank WDI
`trade_gdp`	Trade (exports plus imports) (% of GDP) · World Bank WDI
`labour`	Labour force participation (% of population 15+) · World Bank WDI

Responses and errors

Successful requests return 200 with a JSON body. Errors use standard HTTP status codes with a JSON message:

400 an unknown indicator or invalid parameter.
404 no dataset or route with that name.
429 or 503 too many requests; wait and retry.

Request

curl https://ecodatatechnologies.com/wp-json/ecodata/v1/datasets/does-not-exist

Response404 Not Found · application/json

{
    "code": "not_found",
    "message": "No dataset with that slug. See /datasets for the catalogue.",
    "data": {
        "status": 404
    }
}

Figures are returned as published, so values such as "14.63%" keep their units. Dates use ISO 8601. Responses carry a Cache-Control header; please respect it.

Usage limits and pricing

Each IP address can make up to 60 requests a minute on the public endpoints. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers; above the limit you get a 429 with a Retry-After header.
Responses are cached for up to an hour, so polling more often returns the same data.

PublicFree

All public endpoints, no key needed, fair use (up to 60 requests a minute)

InstitutionalOn request

Higher limits, bulk downloads and support, once licensing arrangements are in place

Terms of use

Data is published under CC BY 4.0 unless stated otherwise. Credit “Source: Eco Data Technologies (www.ecodatatechnologies.com)” and the original publisher shown in each record.

Cache responses on your side and avoid polling more often than the data changes. Market figures update once each business day; most indicators change monthly or quarterly.
Keep requests to a reasonable rate. For bulk or high-frequency access, contact us and we will help.
Figures are for information only and are not investment, tax or legal advice. See our methodology for sources and update schedules.

Use of the API is covered by our licensing and terms of use.

Technical support

Found a bug, an error in the data or something unclear in these docs? Tell us the endpoint, the request you sent and what you expected.

Email enquiries@ecodatatechnologies.com Use the contact form