Skip to content
Plus234Feed

API docs

Build with the Plus234Feed Intel API.

Use a simple API key header to access Nigerian market, macro, policy, NBS, civic, and public-data endpoints.

Live API response

/v1/rates/usd

200 OK

API status

Live

API base

intel-api.plus234feed.com

Auth

X-API-Key

Envelope

v1

{
  "data": { "currency": "USD", "rate": 1326.0192 },
  "source": { "name": "Central Bank of Nigeria" },
  "freshness": { "status": "fresh" }
}

Quick start

Fetch the latest official USD/NGN rate.

Replace pfi_your_key with your assigned API key.

curl -H "X-API-Key: pfi_your_key" \
  https://intel-api.plus234feed.com/v1/rates/usd
const res = await fetch("https://intel-api.plus234feed.com/v1/rates/usd", {
  headers: { "X-API-Key": process.env.PLUS234FEED_INTEL_KEY }
});

const payload = await res.json();
console.log(payload.data.rate);

Example response

{
  "data": {
    "currency": "USD",
    "rate": 1326.0192,
    "rate_date": "2026-09-11"
  },
  "meta": {
    "request_id": "req_...",
    "version": "v1",
    "dataset": "cbn_exchange"
  },
  "source": {
    "name": "Central Bank of Nigeria"
  },
  "freshness": {
    "status": "fresh",
    "data_period": "2026-09-11"
  }
}

Endpoint reference

Available endpoints.

These are the endpoints currently available through the Intel service.

Rates

Official exchange-rate endpoints with freshness and source metadata.

GET/v1/rates/usd

Latest official USD/NGN rate

GET/v1/rates/all

Latest available exchange-rate records

GET/v1/rates/history?currency=USD&limit=30

Historical records

GET/v1/mpr/latest

Latest monetary policy indicators

GET/v1/mpr/ntb/latest

Latest NTB auction result

GET/v1/mpr/ntb/history?limit=20

NTB auction history

Inflation and NBS

Inflation and selected NBS datasets with period and freshness metadata.

GET/v1/inflation/latest

Latest inflation record

GET/v1/inflation/history?limit=24

Inflation history

GET/v1/nbs/status

NBS dataset inventory and freshness

GET/v1/nbs/cpi/latest

Latest CPI dataset record

GET/v1/nbs/fuel-prices/latest

Latest fuel price records

GET/v1/nbs/food-prices/latest

Latest selected food price records

GET/v1/nbs/transport-fares/latest

Latest transport fare records

GET/v1/nbs/cost-of-healthy-diet/latest

Latest healthy diet cost records

GET/v1/nbs/foreign-trade/latest

Latest foreign trade records

GET/v1/nbs/capital-importation/latest

Latest capital importation records

GET/v1/nbs/gdp/latest

Latest GDP dataset records

GET/v1/nbs/debt/latest

Latest debt dataset records

GET/v1/nbs/vat/latest

Latest VAT dataset records

GET/v1/nbs/igr/latest

Latest IGR dataset records

GET/v1/nbs/petrol-pms/latest

Latest petrol price records

GET/v1/nbs/diesel-ago/latest

Latest diesel price records

GET/v1/nbs/kerosene-nhk/latest

Latest kerosene price records

GET/v1/nbs/cooking-gas-lpg/latest

Latest cooking gas price records

Markets

NGX endpoints for market products.

GET/v1/markets/ngx/snapshot

Latest NGX market snapshot

GET/v1/markets/ngx/movers

Top gainers, losers, and trades

GET/v1/markets/ngx/history?limit=30

Historical NGX market snapshots

GET/v1/markets/ngx/summary

Latest packaged NGX daily summary

GET/v1/markets/ngx/summary/history?limit=30

Historical NGX daily summaries

GET/v1/markets/ngx/tickers?search=GT&limit=20

Latest ticker directory with search

GET/v1/markets/ngx/ticker/GTCO

Single ticker lookup

GET/v1/markets/ngx/bonds

Latest NGX bond table

GET/v1/markets/ngx/etfs

Latest NGX ETF table

GET/v1/markets/ngx/filings?company=DANGCEM

Corporate filings and documents

GET/v1/markets/ngx/filings/types

Available filing categories

Macro and civic

Packaged national data for dashboards, research, and internal tools.

GET/v1/macro/snapshot

Packaged macro intelligence payload

GET/v1/macro/brief

Analyst-style macro brief with interpretation and caveats

GET/v1/datasets/freshness

Freshness, source, cadence, and caveat status for Intel datasets

GET/v1/states

All Nigerian states/FCT with representation coverage

GET/v1/states/{state}

State profile with LGAs and federal representation

GET/v1/states/{state}/lgas

LGAs in a state

GET/v1/states/{state}/senatorial-districts

Senatorial districts with current senators

GET/v1/states/{state}/federal-constituencies

Federal constituencies with current representatives

GET/v1/states/{state}/constituencies

Combined senatorial and House constituency view

GET/v1/officials/senators

109-seat Senate roster joined to reference seats

GET/v1/officials/representatives

360-seat House roster joined to reference seats

GET/v1/officials/{official_id}/bills

Bills a member sponsored, with status and reading dates

GET/v1/officials/{official_id}/activity

Motions, reports and bill readings from the order papers, with the coverage window

GET/v1/elections/2027/seats

Every Senate and House seat with its 2027 candidate count and sitting member

GET/v1/elections/2027/seats/{code}

One seat's 2027 candidates, by code: SD-007-AK (Senate), FC-003-AB (House) or SC-243-DT (State Assembly)

GET/v1/elections/2027/presidential

Presidential tickets: candidate and running mate

GET/v1/elections/2027/governorship

Governorship tickets in the 28 states voting in 2027: governor and deputy, with age, gender and qualifications

GET/v1/elections/2027/state-assembly

A state's House of Assembly constituencies with candidate counts (?state=Kano)

GET/v1/elections/2027/state-assembly/{state}/{slug}

Every candidate for one state constituency, with age, gender and qualifications

Need a key for integration testing?

Tell us your use case and the datasets you need. We will provision an API key and onboarding notes.

Request access