DataNexusAI API Documentation

GET/api/sebra/getPeriodsWithMostPaymentsx402 paid

Periods with the largest payment sums

Which calendar slots (days, months, or weekdays) have the largest SEBRA payment sums and how many payments.

Param	In	Type	Description
`period` (required)	query	string	One of: days, months, weekdays. Or pass as flag ?days / ?months / ?weekdays.
`from`	query	string	Inclusive start (DD-MM-YYYY or MM-YYYY).
`to`	query	string	Inclusive end (DD-MM-YYYY or MM-YYYY).
`currency`	query	string	BGN or EUR. Omit to group by currency.
`year`	query	integer	Restrict to one calendar year.
`limit`	query	integer	Max rows after sorting by amount.

Example: GET /api/sebra/getPeriodsWithMostPayments?period=days&from=01-10-2020&to=01-11-2020

GET https://api.datanexusai.org/api/sebra/getPeriodsWithMostPayments?period=days&from=01-10-2020&to=01-11-2020

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "getPeriodsWithMostPayments",
  "period": "days",
  "count": 1,
  "items": [
    {
      "day_of_month": 28,
      "total_amount": "1234567.89",
      "payment_count": 42
    }
  ]
}

GET/api/sebra/getTaxonomyForYearx402 paid

SEBRA taxonomy for a calendar year

Where money went in a year: Salaries, Maintenance, Capital expenditure, etc.

Param	In	Type	Description
`year` (required)	query	integer	Calendar year.
`currency`	query	string	BGN or EUR.

Example: GET /api/sebra/getTaxonomyForYear?year=2019

GET https://api.datanexusai.org/api/sebra/getTaxonomyForYear?year=2019

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "getTaxonomyForYear",
  "year": 2019,
  "items": [
    {
      "category": "Заплати",
      "category_key": "salaries",
      "total_amount": "500000.00"
    }
  ]
}

GET/api/sebra/getTaxonomyForPeriodx402 paid

SEBRA taxonomy for a date window

Same account buckets as getTaxonomyForYear, for from/to dates.

Param	In	Type	Description
`from` (required)	query	string	Start date DD-MM-YYYY or MM-YYYY.
`to`	query	string	End date; defaults to today.
`currency`	query	string	BGN or EUR.

Example: GET /api/sebra/getTaxonomyForPeriod?from=01-10-2020&to=01-11-2020

GET https://api.datanexusai.org/api/sebra/getTaxonomyForPeriod?from=01-10-2020&to=01-11-2020

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/sebra/getMostSponsoredProgrammex402 paid

Most sponsored programmes

Programmes ranked by total amount (then payment count).

Param	In	Type	Description
`year`	query	integer	Calendar year (or use from/to).
`from`	query	string	Window start DD-MM-YYYY or MM-YYYY.
`to`	query	string	Window end.
`currency`	query	string	BGN or EUR.
`limit`	query	integer	Max programmes.

Example: GET /api/sebra/getMostSponsoredProgramme?year=2019

GET https://api.datanexusai.org/api/sebra/getMostSponsoredProgramme?year=2019

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/sebra/getUnusualPaymentsx402 paid

Unusual SEBRA payment activity

Unusual days, programmes, expense spikes, and payment-count outliers for a year or date window.

Param	In	Type	Description
`year`	query	integer	Calendar year.
`from`	query	string	Window start.
`to`	query	string	Window end.
`currency`	query	string	BGN or EUR.
`limit`	query	integer	Max items per list (default 5).

Example: GET /api/sebra/getUnusualPayments?year=2019&limit=5

GET https://api.datanexusai.org/api/sebra/getUnusualPayments?year=2019&limit=5

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

PTP (road accidents)

Bulgarian MoI road accident reports and deadly location clusters. Category page →

GET/api/ptp/getPtpPerCityx402 paid

Road accidents for a city

Crashes for a city (Latin or Cyrillic names). Optional year or from/to.

Param	In	Type	Description
`city` (required)	query	string	City name (e.g. Sofia, Варна).
`year`	query	integer	Calendar year.
`from`	query	string	Window start.
`to`	query	string	Window end.
`limit`	query	integer	Max rows (newest first).

Example: GET /api/ptp/getPtpPerCity?city=Sofia&year=2025

GET https://api.datanexusai.org/api/ptp/getPtpPerCity?city=Sofia&year=2025

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/ptp/getPtpPerRegionx402 paid

Road accidents for a region/oblast

Crashes in a district/oblast. Sofia maps to Sofia city, not district.

Param	In	Type	Description
`region` (required)	query	string	Region/oblast name.
`year`	query	integer	Calendar year.
`from`	query	string	Window start.
`to`	query	string	Window end.
`limit`	query	integer	Max rows.

Example: GET /api/ptp/getPtpPerRegion?region=Sofia&year=2025

GET https://api.datanexusai.org/api/ptp/getPtpPerRegion?region=Sofia&year=2025

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/ptp/getMostDeadlyLocationsx402 paid

Deadliest crash location clusters

Deadliest 2 km crash clusters for a year or date window.

Param	In	Type	Description
`year`	query	integer	Calendar year.
`from`	query	string	Window start.
`to`	query	string	Window end.
`limit`	query	integer	Max clusters (default 20).

Example: GET /api/ptp/getMostDeadlyLocations?year=2020

GET https://api.datanexusai.org/api/ptp/getMostDeadlyLocations?year=2020

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Hearthstone

GET/api/hearthstone/getCardx402 paid

Get Hearthstone card (EN + BG)

Returns structured bilingual Hearthstone card information. Provide name and/or dbf_id.

Param	In	Type	Description
`name`	query	string	English card name (case-insensitive).
`dbf_id`	query	integer	Numeric Hearthstone dbf id.

Example: GET /api/hearthstone/getCard?name=Fireball

GET https://api.datanexusai.org/api/hearthstone/getCard?name=Fireball

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "query": {
    "name": "Fireball"
  },
  "count": 1,
  "items": [
    {
      "en": {
        "name": "Fireball",
        "dbf_id": 315
      },
      "bg": {
        "name": "Огнена топка"
      }
    }
  ]
}

GET/api/hearthstone/getTranslatedCardInBGx402 paid

Translate Hearthstone card to Bulgarian

Look up English card name; return matching Bulgarian card rows.

Param	In	Type	Description
`name` (required)	query	string	English card name.

Example: GET /api/hearthstone/getTranslatedCardInBG?name=Fireball

GET https://api.datanexusai.org/api/hearthstone/getTranslatedCardInBG?name=Fireball

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/hearthstone/getCardsByClassx402 paid

List Hearthstone cards by class

All cards for a class (e.g. Shaman). Each item has en and optional bg.

Param	In	Type	Description
`class` (required)	query	string	Card class (Shaman, Mage, …).
`collectible`	query	boolean	Filter collectible cards.
`limit`	query	integer	Max rows (default 200).

Example: GET /api/hearthstone/getCardsByClass?class=Shaman

GET https://api.datanexusai.org/api/hearthstone/getCardsByClass?class=Shaman

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Agri-food

GET/api/v1/datasetsx402 paid

List agri-food datasets

Latest import metadata per dataset (cereals, oilseeds, pigmeat).

Param	In	Type	Description
`limit`	query	integer	Page size (optional).
`offset`	query	integer	Offset (optional).

Example: GET /api/v1/datasets?limit=100

GET https://api.datanexusai.org/api/v1/datasets?limit=100

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

[
  {
    "dataset": "cereals_prices",
    "row_count": 1000
  }
]

GET/api/v1/datasets/{dataset_id}x402 paid

Agri-food dataset detail

Import versions for one dataset id.

Param	In	Type	Description
`dataset_id` (required)	path	string	e.g. cereals_prices, oilseeds_prices, pigmeat_prices.

Example: GET /api/v1/datasets/cereals_prices

GET https://api.datanexusai.org/api/v1/datasets/cereals_prices

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/commoditiesx402 paid

List commodities

Commodity catalog across cereals, oilseeds, and pigmeat.

Param	In	Type	Description
`dataset`	query	string	Filter by dataset id.
`q`	query	string	Search product name / pig class.
`limit`	query	integer	Page size (default 100).
`offset`	query	integer	Offset.

Example: GET /api/v1/commodities?dataset=cereals_prices&limit=20

GET https://api.datanexusai.org/api/v1/commodities?dataset=cereals_prices&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/commodities/{commodity_id}/pricesx402 paid

Prices for one commodity

Price rows for a commodity id, newest first.

Param	In	Type	Description
`commodity_id` (required)	path	string	Commodity id e.g. cereals_prices:Milling rye
`country`	query	string	Member state code or name.
`date_from`	query	string	ISO date start.
`date_to`	query	string	ISO date end.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/commodities/cereals_prices:Milling rye/prices?country=AT&limit=20

GET https://api.datanexusai.org/api/v1/commodities/cereals_prices:Milling rye/prices?country=AT&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/commodities/{commodity_id}/historyx402 paid

Price history for one commodity

Time series for a commodity (begin_date ascending).

Param	In	Type	Description
`commodity_id` (required)	path	string	Commodity id.
`country`	query	string	Member state.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/commodities/cereals_prices:Milling rye/history?country=AT&limit=20

GET https://api.datanexusai.org/api/v1/commodities/cereals_prices:Milling rye/history?country=AT&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/countriesx402 paid

List member states

EU member states from agrifood_member_state.

Param	In	Type	Description
`dataset`	query	string	Optional: countries present in that dataset.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/countries

GET https://api.datanexusai.org/api/v1/countries

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/pricesx402 paid

Query agri-food prices

Union of cereals, oilseeds, and pigmeat price facts.

Param	In	Type	Description
`dataset`	query	string	Dataset id.
`country`	query	string	Member state.
`commodity`	query	string	Product / pig class.
`date_from`	query	string	Start date.
`date_to`	query	string	End date.
`market`	query	string	Market name.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/prices?dataset=cereals_prices&country=BG&date_from=2024-01-01&limit=20

GET https://api.datanexusai.org/api/v1/prices?dataset=cereals_prices&country=BG&date_from=2024-01-01&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/prices/changesx402 paid

Weekly agri-food price changes

Period-to-period LAG changes for agri-food price series.

Param	In	Type	Description
`dataset`	query	string	Dataset id.
`country`	query	string	Member state.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/prices/changes?dataset=pigmeat_prices&country=BG&limit=20

GET https://api.datanexusai.org/api/v1/prices/changes?dataset=pigmeat_prices&country=BG&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/anomaliesx402 paid

Agri-food price anomalies

Rows with large percent change or z-score within a series.

Param	In	Type	Description
`min_percent`	query	number	Min \|percent_change\| (default 25).
`z`	query	number	Min \|zscore\| (default 3).
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/anomalies?min_percent=40&limit=20

GET https://api.datanexusai.org/api/v1/anomalies?min_percent=40&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/latestx402 paid

Latest prices per series

Newest begin_date per agri-food price series.

Param	In	Type	Description
`dataset`	query	string	Dataset id.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/latest?dataset=oilseeds_prices&limit=20

GET https://api.datanexusai.org/api/v1/latest?dataset=oilseeds_prices&limit=20

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Trade and markets

GET/api/v1/changesx402 paid

Period-to-period trade/price changes

Changes for price, imports, exports, trade_balance. If dataset= is set, routes to agri-food price changes.

Param	In	Type	Description
`country`	query	string	Reporter country.
`commodity`	query	string	Product code or name.
`date_from`	query	string	Start period.
`date_to`	query	string	End period.
`metric`	query	string	price\|imports\|exports\|trade_balance.
`dataset`	query	string	If set, use agri-food price LAG path.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/changes?country=BG&commodity=1001&date_from=2020&date_to=2025&metric=imports

GET https://api.datanexusai.org/api/v1/changes?country=BG&commodity=1001&date_from=2020&date_to=2025&metric=imports

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/tradex402 paid

Comext trade rows

Eurostat Comext trade facts (value and quantity).

Param	In	Type	Description
`reporter`	query	string	Reporter country (or country=).
`partner`	query	string	Partner (often WORLD).
`product`	query	string	Product code (or commodity=).
`flow`	query	string	1/2 or import/export.
`date_from`	query	string	Start period.
`date_to`	query	string	End period.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/trade?reporter=BG&product=1001&date_from=2020

GET https://api.datanexusai.org/api/v1/trade?reporter=BG&product=1001&date_from=2020

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/trade/balancex402 paid

Trade balance

exports - imports on VALUE_IN_EUROS. Requires reporter and product.

Param	In	Type	Description
`country` (required)	query	string	Reporter (or reporter=).
`commodity` (required)	query	string	Product (or product=).
`date_from`	query	string	Start period.
`date_to`	query	string	End period.
`partner`	query	string	Partner (default WORLD).

Example: GET /api/v1/trade/balance?country=BG&commodity=1001

GET https://api.datanexusai.org/api/v1/trade/balance?country=BG&commodity=1001

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/trade/partnersx402 paid

Top trading partners

Ranked partners for reporter+product (excludes WORLD aggregates).

Param	In	Type	Description
`reporter` (required)	query	string	Reporter country.
`product` (required)	query	string	Product code.
`flow`	query	string	import\|export\|both (default both).
`period`	query	string	Period filter.
`date_from`	query	string	Start.
`date_to`	query	string	End.
`limit`	query	integer
`sort`	query	string	value\|quantity\|share.

Example: GET /api/v1/trade/partners?reporter=BG&product=1001&period=2025

GET https://api.datanexusai.org/api/v1/trade/partners?reporter=BG&product=1001&period=2025

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/{country}/{commodity}x402 paid

Market snapshot

Agri-food average price + Comext trade for country/commodity.

Param	In	Type	Description
`country` (required)	path	string	Country code.
`commodity` (required)	path	string	Commodity / product code.
`year`	query	integer	Year.
`date_from`	query	string	Start.
`date_to`	query	string	End.
`partner`	query	string	Partner (default WORLD).

Example: GET /api/v1/markets/BG/1001

GET https://api.datanexusai.org/api/v1/markets/BG/1001

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/{country}/{commodity}/historyx402 paid

Market history

Annual series: price, imports, exports, trade_balance.

Param	In	Type	Description
`country` (required)	path	string	Country code.
`commodity` (required)	path	string	Commodity code.
`date_from`	query	string	Start.
`date_to`	query	string	End.

Example: GET /api/v1/markets/BG/1001/history?date_from=2020&date_to=2025

GET https://api.datanexusai.org/api/v1/markets/BG/1001/history?date_from=2020&date_to=2025

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/{country}/{commodity}/insightsx402 paid

Market insights

YoY percent changes and z-score anomalies (deterministic).

Param	In	Type	Description
`country` (required)	path	string	Country code.
`commodity` (required)	path	string	Commodity code.
`z`	query	number	Z-score threshold (default 3).

Example: GET /api/v1/markets/BG/1001/insights

GET https://api.datanexusai.org/api/v1/markets/BG/1001/insights

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/changesx402 paid

Cross-market YoY changes

YoY moves with |percent| >= min_percent across markets.

Param	In	Type	Description
`countries`	query	string	Comma-separated countries.
`commodities`	query	string	Comma-separated commodities.
`min_percent`	query	number	Default 10.
`limit`	query	integer
`offset`	query	integer

Example: GET /api/v1/markets/changes?countries=BG&commodities=1001&min_percent=10

GET https://api.datanexusai.org/api/v1/markets/changes?countries=BG&commodities=1001&min_percent=10

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/anomaliesx402 paid

Cross-market anomalies

Large YoY or z-score moves on price/imports.

Param	In	Type	Description
`countries`	query	string	Comma-separated countries.
`commodities`	query	string	Comma-separated commodities.
`min_percent`	query	number	Default 40.
`z`	query	number	Z-score threshold.
`limit`	query	integer

Example: GET /api/v1/markets/anomalies?countries=BG&commodities=1001

GET https://api.datanexusai.org/api/v1/markets/anomalies?countries=BG&commodities=1001

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/v1/markets/comparex402 paid

Compare countries for one commodity

Compare 2+ countries for one commodity and period.

Param	In	Type	Description
`countries` (required)	query	string	Comma-separated country codes.
`commodity` (required)	query	string	Commodity code.
`date_from`	query	string	Start period.
`date_to`	query	string	End period.

Example: GET /api/v1/markets/compare?countries=BG%2CRO%2CGR%2CDE&commodity=1001

GET https://api.datanexusai.org/api/v1/markets/compare?countries=BG%2CRO%2CGR%2CDE&commodity=1001

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Macro & rates (derived)

Derived EU macro, ECB monetary stance, yield-curve slopes, EURUSD analytics, and selected FRED-backed derived indicators. Raw FRED series are not exposed as DataNexusAI endpoints. Category page →

GET/api/v1/macro/eu-inflation-divergencex402 paid

EU HICP inflation divergence vs euro area

Derived cross-country inflation gaps: member-state HICP YoY minus EA20/EU27 benchmark, plus MoM from the HICP index. Ranked by absolute gap.

Param	In	Type	Description
`period`	query	string	Optional period filter (e.g. 2024-08). Default: latest.

Example: GET /api/v1/macro/eu-inflation-divergence

GET https://api.datanexusai.org/api/v1/macro/eu-inflation-divergence

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "eu_inflation_divergence",
  "benchmark": {
    "geo": "EA20",
    "yoy_pct": 2.1
  },
  "results": [
    {
      "geo": "BG",
      "yoy_pct": 3.5,
      "gap_vs_benchmark_pp": 1.4
    }
  ]
}

GET/api/v1/rates/ecb-stancex402 paid

ECB policy corridor and €STR stance

Derived monetary stance: DFR/MRO/MLFR corridor width, €STR−DFR spread, and a liquidity stance label. Not a raw rate dump.

Example: GET /api/v1/rates/ecb-stance

GET https://api.datanexusai.org/api/v1/rates/ecb-stance

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "ecb_stance",
  "derived": {
    "corridor_width_pp": 0.75,
    "estr_minus_dfr_pp": 0.02,
    "liquidity_stance": "balanced"
  }
}

GET/api/v1/rates/eu-curve-slopex402 paid

Euro-area yield curve slopes

Derived AAA euro-area yield-curve slopes (10Y−2Y, 30Y−10Y), butterfly, and steep/flat/inverted regime.

Example: GET /api/v1/rates/eu-curve-slope

GET https://api.datanexusai.org/api/v1/rates/eu-curve-slope

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "eu_curve_slope",
  "derived": {
    "slope_10y_2y_pp": 0.45,
    "regime": "normal"
  }
}

GET/api/v1/fx/eurusd-analyticsx402 paid

EURUSD returns, vol, drawdown analytics

Derived FX layer on ECB EURUSD reference: multi-horizon returns, annualized vol, percentile, z-score, max drawdown.

Param	In	Type	Description
`lookback_days`	query	integer	History window for percentile/z-score (default 252).

Example: GET /api/v1/fx/eurusd-analytics?lookback_days=252

GET https://api.datanexusai.org/api/v1/fx/eurusd-analytics?lookback_days=252

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "eurusd_analytics",
  "spot": 1.08,
  "derived": {
    "return_1m_pct": 1.2,
    "vol_21d_annualized_pct": 7.5
  }
}

GET/api/analytics/us/yield-curvex402 paid

US 10Y−2Y Treasury spread (derived)

Runtime FRED DGS10 − DGS2. Returns a single derived spread — not raw Treasury series. Requires license_status=APPROVED for both series.

Example: GET /api/analytics/us/yield-curve

GET https://api.datanexusai.org/api/analytics/us/yield-curve

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "indicator": "US_10Y_2Y_SPREAD",
  "date": "2026-09-24",
  "value": 0.42,
  "unit": "percentage_points"
}

GET/api/analytics/us-eu/inflationx402 paid

US vs EU inflation differential (derived)

Runtime FRED CPI YoY vs Eurostat HICP YoY. Derived differential only. Requires CPIAUCSL license_status=APPROVED.

Example: GET /api/analytics/us-eu/inflation

GET https://api.datanexusai.org/api/analytics/us-eu/inflation

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "indicator": "US_EU_INFLATION_DIFFERENTIAL",
  "us_inflation": 2.9,
  "eu_inflation": 2.1,
  "differential": 0.8
}

GET/api/analytics/us/macrox402 paid

US macro regime snapshot (derived)

Derived inflation/unemployment/fed-funds changes and a macro regime label from runtime FRED inputs. No raw series arrays.

Example: GET /api/analytics/us/macro

GET https://api.datanexusai.org/api/analytics/us/macro

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/analytics/market/volatility-regimex402 paid

Market volatility regime from VIX (derived)

Runtime VIXCLS → regime / percentile / z-score. Requires VIXCLS license_status=APPROVED. Not a raw VIX endpoint.

Param	In	Type	Description
`lookback_days`	query	integer	Lookback window (default 252).

Example: GET /api/analytics/market/volatility-regime?lookback_days=252

GET https://api.datanexusai.org/api/analytics/market/volatility-regime?lookback_days=252

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/economic/oecd/series/{series_code}x402 paid

OECD KEI series by canonical code

Observations for one OECD Key Economic Indicator series (e.g. OECD_CLI_USA, OECD_UNEMP_DEU). Attribution: OECD SDMX.

Param	In	Type	Description
`limit`	query	integer	Max observations (default 120).

Example: GET /api/economic/oecd/series/{series_code}?limit=24

GET https://api.datanexusai.org/api/economic/oecd/series/{series_code}?limit=24

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "oecd_series",
  "series_code": "OECD_CLI_USA",
  "geo": "USA",
  "observations": [
    {
      "period": "2024-01",
      "value": 99.1
    }
  ]
}

GET/api/economic/oecd/country/{country}x402 paid

OECD KEI latest snapshot for a country

Latest CLI, business/consumer confidence, industrial production, retail trade, and unemployment for an ISO3 country (USA, DEU, …).

Example: GET /api/economic/oecd/country/{country}

GET https://api.datanexusai.org/api/economic/oecd/country/{country}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "oecd_country",
  "country": "USA",
  "indicators": [
    {
      "canonical_code": "OECD_CLI_USA",
      "value": 99.3
    }
  ]
}

GET/api/economic/country/{code}/overviewx402 paid

Cross-source country economic overview

Combined Eurostat + ECB + OECD KEI + World Bank WDI snapshot for a country (ISO2 or ISO3). Multi-source value-add.

Example: GET /api/economic/country/{code}/overview

GET https://api.datanexusai.org/api/economic/country/{code}/overview

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "country_overview",
  "country": "DE",
  "sources_present": [
    "oecd",
    "eurostat",
    "ecb",
    "worldbank"
  ]
}

GET/api/economic/worldbank/series/{series_code}x402 paid

World Bank WDI series by canonical code

Observations for one World Bank WDI series (e.g. WB_GDP_PER_CAPITA_USA). Attribution: World Bank.

Param	In	Type	Description
`limit`	query	integer	Max observations (default 120).

Example: GET /api/economic/worldbank/series/{series_code}?limit=25

GET https://api.datanexusai.org/api/economic/worldbank/series/{series_code}?limit=25

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "worldbank_series",
  "series_code": "WB_GDP_PER_CAPITA_USA",
  "geo": "USA",
  "observations": [
    {
      "period": "2022",
      "value": 76329.6
    }
  ]
}

GET/api/economic/worldbank/country/{country}x402 paid

World Bank WDI latest snapshot for a country

Latest allowlisted WDI structural indicators for an ISO3 country.

Example: GET /api/economic/worldbank/country/{country}

GET https://api.datanexusai.org/api/economic/worldbank/country/{country}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

Example response shape:

{
  "endpoint": "worldbank_country",
  "country": "USA",
  "indicators": {
    "gdp_per_capita": {
      "value": 76329.6
    }
  }
}

GET/api/analytics/trade-openness/{code}x402 paid

Trade openness (exports+imports %GDP)

Derived: NE.EXP.GNFS.ZS + NE.IMP.GNFS.ZS from World Bank WDI.

Example: GET /api/analytics/trade-openness/{code}

GET https://api.datanexusai.org/api/analytics/trade-openness/{code}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/analytics/debt-burden/{code}x402 paid

Government debt burden (% GDP)

Derived structural debt burden from GC.DOD.TOTL.GD.ZS.

Example: GET /api/analytics/debt-burden/{code}

GET https://api.datanexusai.org/api/analytics/debt-burden/{code}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/analytics/energy-dependency/{code}x402 paid

Energy imports and renewable share

Derived energy dependency metrics from World Bank WDI.

Example: GET /api/analytics/energy-dependency/{code}

GET https://api.datanexusai.org/api/analytics/energy-dependency/{code}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.

GET/api/analytics/country-structure/{code}x402 paid

Structural country profile (World Bank derived)

Composite structural snapshot: trade openness, debt, energy, FDI, demographics, carbon intensity. Value-add analytics (x402).

Example: GET /api/analytics/country-structure/{code}

GET https://api.datanexusai.org/api/analytics/country-structure/{code}

Payment: x402 · $0.01 USDC · networks: Base, Polygon, Arbitrum One. Unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED.