Global Financial Markets & Macro Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/macro-intelligence/central-bank-rate-compare$0.04 USDC

Compare central bank rates

Compare supplied policy rates across countries and banks. Missing previous rates leave change blank rather than inventing values.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "rates": [
    {
      "id": "R-1",
      "country": "US",
      "bank": "Federal Reserve",
      "asOf": "2026-09-17",
      "rate": 5.25,
      "previousRate": 5.5,
      "source": "Caller-supplied Fed publication excerpt"
    },
    {
      "id": "R-2",
      "country": "EA",
      "bank": "ECB",
      "asOf": "2026-09-11",
      "rate": 3.5,
      "previousRate": 3.75,
      "source": "Caller-supplied ECB publication excerpt"
    },
    {
      "id": "R-3",
      "country": "GB",
      "bank": "Bank of England",
      "asOf": "2026-09-18",
      "rate": 4.75,
      "previousRate": 5,
      "source": "Caller-supplied BoE publication excerpt"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "compared",
  "countryCount": 3,
  "averageRate": 4.5,
  "averageRateSupplied": true,
  "items": [
    {
      "id": "R-2",
      "country": "EA",
      "bank": "ECB",
      "asOf": "2026-09-11",
      "rate": 3.5,
      "rateSupplied": true,
      "previousRate": 3.75,
      "previousRateSupplied": true,
      "changePctPoints": -0.25,
      "changePctPointsSupplied": true,
      "source": "Caller-supplied ECB publication excerpt",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "R-3",
      "country": "GB",
      "bank": "Bank of England",
      "asOf": "2026-09-18",
      "rate": 4.75,
      "rateSupplied": true,
      "previousRate": 5,
      "previousRateSupplied": true,
      "changePctPoints": -0.25,
      "changePctPointsSupplied": true,
      "source": "Caller-supplied BoE publication excerpt",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "R-1",
      "country": "US",
      "bank": "Federal Reserve",
      "asOf": "2026-09-17",
      "rate": 5.25,
      "rateSupplied": true,
      "previousRate": 5.5,
      "previousRateSupplied": true,
      "changePctPoints": -0.25,
      "changePctPointsSupplied": true,
      "source": "Caller-supplied Fed publication excerpt",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/central-bank-rate-compare" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "rates": [
    {
      "id": "R-1",
      "country": "US",
      "bank": "Federal Reserve",
      "asOf": "2026-09-17",
      "rate": 5.25,
      "previousRate": 5.5,
      "source": "Caller-supplied Fed publication excerpt"
    },
    {
      "id": "R-2",
      "country": "EA",
      "bank": "ECB",
      "asOf": "2026-09-11",
      "rate": 3.5,
      "previousRate": 3.75,
      "source": "Caller-supplied ECB publication excerpt"
    },
    {
      "id": "R-3",
      "country": "GB",
      "bank": "Bank of England",
      "asOf": "2026-09-18",
      "rate": 4.75,
      "previousRate": 5,
      "source": "Caller-supplied BoE publication excerpt"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/yield-curve-analyze$0.05 USDC

Analyze yield curves

Analyze supplied sovereign yield tenors for slope, curvature, and curve shape without inventing missing points.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "tenors": [
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "2y",
      "yieldPct": 3.8,
      "source": "Caller-supplied Treasury curve"
    },
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "10y",
      "yieldPct": 4.2,
      "source": "Caller-supplied Treasury curve"
    },
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "30y",
      "yieldPct": 4.5,
      "source": "Caller-supplied Treasury curve"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "items": [
    {
      "country": "US",
      "asOf": "2026-10-01",
      "pointCount": 3,
      "shortTenor": "2y",
      "longTenor": "30y",
      "shortYield": 3.8,
      "shortYieldSupplied": true,
      "longYield": 4.5,
      "longYieldSupplied": true,
      "slopePctPoints": 0.7,
      "slopePctPointsSupplied": true,
      "curvaturePctPoints": -0.7,
      "curvaturePctPointsSupplied": true,
      "shape": "upward",
      "points": [
        {
          "tenor": "2y",
          "months": 24,
          "yieldPct": 3.8,
          "source": "Caller-supplied Treasury curve"
        },
        {
          "tenor": "10y",
          "months": 120,
          "yieldPct": 4.2,
          "source": "Caller-supplied Treasury curve"
        },
        {
          "tenor": "30y",
          "months": 360,
          "yieldPct": 4.5,
          "source": "Caller-supplied Treasury curve"
        }
      ],
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/yield-curve-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tenors": [
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "2y",
      "yieldPct": 3.8,
      "source": "Caller-supplied Treasury curve"
    },
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "10y",
      "yieldPct": 4.2,
      "source": "Caller-supplied Treasury curve"
    },
    {
      "country": "US",
      "asOf": "2026-10-01",
      "tenor": "30y",
      "yieldPct": 4.5,
      "source": "Caller-supplied Treasury curve"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/inflation-series-compare$0.04 USDC

Compare inflation series

Compare supplied CPI or inflation observations by country using the latest and previous points only.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "series": [
    {
      "id": "CPI-US",
      "name": "US CPI YoY",
      "country": "US",
      "kind": "inflation",
      "unit": "%"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%",
      "source": "Caller-supplied BLS excerpt"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%",
      "source": "Caller-supplied BLS excerpt"
    },
    {
      "seriesId": "CPI-EA",
      "country": "EA",
      "date": "2026-08",
      "value": 2.1,
      "unit": "%",
      "source": "Caller-supplied Eurostat excerpt"
    },
    {
      "seriesId": "CPI-EA",
      "country": "EA",
      "date": "2026-09",
      "value": 2,
      "unit": "%",
      "source": "Caller-supplied Eurostat excerpt"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "compared",
  "items": [
    {
      "country": "US",
      "observationCount": 2,
      "latestDate": "2026-09",
      "latestValue": 3.1,
      "latestValueSupplied": true,
      "previousDate": "2026-08",
      "previousValue": 2.9,
      "previousValueSupplied": true,
      "change": 0.2,
      "changeSupplied": true,
      "unit": "%",
      "source": "Caller-supplied BLS excerpt",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "country": "EA",
      "observationCount": 2,
      "latestDate": "2026-09",
      "latestValue": 2,
      "latestValueSupplied": true,
      "previousDate": "2026-08",
      "previousValue": 2.1,
      "previousValueSupplied": true,
      "change": -0.1,
      "changeSupplied": true,
      "unit": "%",
      "source": "Caller-supplied Eurostat excerpt",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/inflation-series-compare" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "series": [
    {
      "id": "CPI-US",
      "name": "US CPI YoY",
      "country": "US",
      "kind": "inflation",
      "unit": "%"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%",
      "source": "Caller-supplied BLS excerpt"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%",
      "source": "Caller-supplied BLS excerpt"
    },
    {
      "seriesId": "CPI-EA",
      "country": "EA",
      "date": "2026-08",
      "value": 2.1,
      "unit": "%",
      "source": "Caller-supplied Eurostat excerpt"
    },
    {
      "seriesId": "CPI-EA",
      "country": "EA",
      "date": "2026-09",
      "value": 2,
      "unit": "%",
      "source": "Caller-supplied Eurostat excerpt"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/economic-indicator-release-track$0.04 USDC

Track economic indicator releases

Track supplied indicator release dates with actual, consensus, and previous values when present.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "releases": [
    {
      "id": "REL-1",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "consensus": 3,
      "previous": 2.9,
      "unit": "%",
      "source": "Caller-supplied release calendar"
    },
    {
      "id": "REL-2",
      "indicator": "Unemployment",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-03",
      "actual": 4.2,
      "consensus": 4.2,
      "previous": 4.1,
      "unit": "%",
      "source": "Caller-supplied release calendar"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "tracked",
  "releaseCount": 2,
  "withConsensusCount": 2,
  "items": [
    {
      "id": "REL-2",
      "indicator": "Unemployment",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-03",
      "actual": 4.2,
      "actualSupplied": true,
      "consensus": 4.2,
      "consensusSupplied": true,
      "previous": 4.1,
      "previousSupplied": true,
      "surprise": 0,
      "surpriseSupplied": true,
      "unit": "%",
      "source": "Caller-supplied release calendar",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "REL-1",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "actualSupplied": true,
      "consensus": 3,
      "consensusSupplied": true,
      "previous": 2.9,
      "previousSupplied": true,
      "surprise": 0.1,
      "surpriseSupplied": true,
      "unit": "%",
      "source": "Caller-supplied release calendar",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/economic-indicator-release-track" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "releases": [
    {
      "id": "REL-1",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "consensus": 3,
      "previous": 2.9,
      "unit": "%",
      "source": "Caller-supplied release calendar"
    },
    {
      "id": "REL-2",
      "indicator": "Unemployment",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-03",
      "actual": 4.2,
      "consensus": 4.2,
      "previous": 4.1,
      "unit": "%",
      "source": "Caller-supplied release calendar"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/surprise-calculate$0.05 USDC

Calculate macro surprises

Calculate actual-minus-consensus surprises from supplied releases and optional z-scores against the sample stdev.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "releases": [
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-07",
      "releaseDate": "2026-08-10",
      "actual": 2.8,
      "consensus": 2.9,
      "unit": "%"
    },
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-08",
      "releaseDate": "2026-09-10",
      "actual": 2.9,
      "consensus": 2.9,
      "unit": "%"
    },
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "consensus": 3,
      "unit": "%"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "sampleCount": 3,
  "surpriseStdev": 0.1,
  "surpriseStdevSupplied": true,
  "items": [
    {
      "id": "REL-1",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-07",
      "releaseDate": "2026-08-10",
      "actual": 2.8,
      "consensus": 2.9,
      "surprise": -0.1,
      "surpriseSupplied": true,
      "zScore": -1,
      "zScoreSupplied": true,
      "unit": "%",
      "source": "",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "REL-2",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-08",
      "releaseDate": "2026-09-10",
      "actual": 2.9,
      "consensus": 2.9,
      "surprise": 0,
      "surpriseSupplied": true,
      "zScore": 0,
      "zScoreSupplied": true,
      "unit": "%",
      "source": "",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "REL-3",
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "consensus": 3,
      "surprise": 0.1,
      "surpriseSupplied": true,
      "zScore": 1,
      "zScoreSupplied": true,
      "unit": "%",
      "source": "",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/surprise-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "releases": [
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-07",
      "releaseDate": "2026-08-10",
      "actual": 2.8,
      "consensus": 2.9,
      "unit": "%"
    },
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-08",
      "releaseDate": "2026-09-10",
      "actual": 2.9,
      "consensus": 2.9,
      "unit": "%"
    },
    {
      "indicator": "CPI YoY",
      "country": "US",
      "period": "2026-09",
      "releaseDate": "2026-10-10",
      "actual": 3.1,
      "consensus": 3,
      "unit": "%"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/currency-purchasing-power-compare$0.05 USDC

Compare currency purchasing power

Compare supplied price indexes adjusted by FX-per-USD values. Missing FX or price indexes are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "priceLevels": [
    {
      "country": "US",
      "currency": "USD",
      "asOf": "2026-01-01",
      "priceIndex": 100,
      "fxPerUsd": 1,
      "source": "Caller-supplied price level"
    },
    {
      "country": "GB",
      "currency": "GBP",
      "asOf": "2026-01-01",
      "priceIndex": 95,
      "fxPerUsd": 0.78,
      "source": "Caller-supplied price level"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "compared",
  "pairCount": 1,
  "items": [
    {
      "id": "P-1",
      "country": "US",
      "currency": "USD",
      "asOf": "2026-01-01",
      "priceIndex": 100,
      "priceIndexSupplied": true,
      "fxPerUsd": 1,
      "fxPerUsdSupplied": true,
      "realIndex": 100,
      "realIndexSupplied": true,
      "source": "Caller-supplied price level",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "P-2",
      "country": "GB",
      "currency": "GBP",
      "asOf": "2026-01-01",
      "priceIndex": 95,
      "priceIndexSupplied": true,
      "fxPerUsd": 0.78,
      "fxPerUsdSupplied": true,
      "realIndex": 121.7949,
      "realIndexSupplied": true,
      "source": "Caller-supplied price level",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "pairs": [
    {
      "leftCountry": "US",
      "rightCountry": "GB",
      "leftRealIndex": 100,
      "rightRealIndex": 121.7949,
      "ratio": 0.8211,
      "ratioSupplied": true,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/currency-purchasing-power-compare" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "priceLevels": [
    {
      "country": "US",
      "currency": "USD",
      "asOf": "2026-01-01",
      "priceIndex": 100,
      "fxPerUsd": 1,
      "source": "Caller-supplied price level"
    },
    {
      "country": "GB",
      "currency": "GBP",
      "asOf": "2026-01-01",
      "priceIndex": 95,
      "fxPerUsd": 0.78,
      "source": "Caller-supplied price level"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/country-risk-profile$0.05 USDC

Profile country macro risk

Summarize supplied inflation, policy rates, and debt into a descriptive risk level. This is not a credit rating.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "rates": [
    {
      "country": "US",
      "bank": "Federal Reserve",
      "asOf": "2026-09-17",
      "rate": 5.25,
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%"
    }
  ],
  "debt": [
    {
      "country": "US",
      "instrument": "UST",
      "maturityDate": "2030-01-15",
      "amount": 500000000000,
      "currency": "USD",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "profiled",
  "items": [
    {
      "country": "US",
      "inflationLatest": 3.1,
      "inflationLatestSupplied": true,
      "policyRate": 5.25,
      "policyRateSupplied": true,
      "debtAmount": 500000000000,
      "debtAmountSupplied": true,
      "signalCount": 3,
      "riskScore": 1,
      "riskLevel": "contained",
      "ratingAssigned": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/country-risk-profile" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "rates": [
    {
      "country": "US",
      "bank": "Federal Reserve",
      "asOf": "2026-09-17",
      "rate": 5.25,
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%"
    }
  ],
  "debt": [
    {
      "country": "US",
      "instrument": "UST",
      "maturityDate": "2030-01-15",
      "amount": 500000000000,
      "currency": "USD",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/sovereign-debt-maturity-analyze$0.04 USDC

Analyze sovereign debt maturity

Bucket supplied sovereign debt amounts by maturity window from the as-of date without inventing missing maturities.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-10-01",
  "debt": [
    {
      "country": "US",
      "instrument": "Bill",
      "maturityDate": "2026-12-15",
      "amount": 100,
      "currency": "USD",
      "source": "Caller-supplied"
    },
    {
      "country": "US",
      "instrument": "Note",
      "maturityDate": "2029-05-15",
      "amount": 250,
      "currency": "USD",
      "source": "Caller-supplied"
    },
    {
      "country": "US",
      "instrument": "Bond",
      "maturityDate": "2045-02-15",
      "amount": 400,
      "currency": "USD",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "items": [
    {
      "country": "US",
      "asOf": "2026-10-01",
      "instrumentCount": 3,
      "totalAmount": 750,
      "totalAmountSupplied": true,
      "currency": "USD",
      "buckets": [
        {
          "bucket": "0_12m",
          "amount": 100,
          "amountSupplied": true
        },
        {
          "bucket": "1_5y",
          "amount": 250,
          "amountSupplied": true
        },
        {
          "bucket": "5_10y",
          "amount": 0,
          "amountSupplied": true
        },
        {
          "bucket": "10y_plus",
          "amount": 400,
          "amountSupplied": true
        }
      ],
      "nearestMaturity": "2026-12-15",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/sovereign-debt-maturity-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-10-01",
  "debt": [
    {
      "country": "US",
      "instrument": "Bill",
      "maturityDate": "2026-12-15",
      "amount": 100,
      "currency": "USD",
      "source": "Caller-supplied"
    },
    {
      "country": "US",
      "instrument": "Note",
      "maturityDate": "2029-05-15",
      "amount": 250,
      "currency": "USD",
      "source": "Caller-supplied"
    },
    {
      "country": "US",
      "instrument": "Bond",
      "maturityDate": "2045-02-15",
      "amount": 400,
      "currency": "USD",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/commodity-price-transmission-analyze$0.05 USDC

Analyze commodity price transmission

Compare supplied commodity price changes with inflation observation changes. Causation is not claimed.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "commodities": [
    {
      "name": "Brent",
      "date": "2026-08-01",
      "price": 80,
      "unit": "USD/bbl",
      "source": "Caller-supplied"
    },
    {
      "name": "Brent",
      "date": "2026-09-01",
      "price": 88,
      "unit": "USD/bbl",
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "items": [
    {
      "commodity": "Brent",
      "unit": "USD/bbl",
      "pointCount": 2,
      "startDate": "2026-08-01",
      "endDate": "2026-09-01",
      "startPrice": 80,
      "endPrice": 88,
      "changePct": 0.1,
      "changePctSupplied": true,
      "inflationLinks": [
        {
          "country": "US",
          "inflationChange": 0.2,
          "inflationChangeSupplied": true,
          "commodityChangePct": 0.1,
          "commodityChangePctSupplied": true,
          "sameDirection": true
        }
      ],
      "causationClaimed": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/commodity-price-transmission-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "commodities": [
    {
      "name": "Brent",
      "date": "2026-08-01",
      "price": 80,
      "unit": "USD/bbl",
      "source": "Caller-supplied"
    },
    {
      "name": "Brent",
      "date": "2026-09-01",
      "price": 88,
      "unit": "USD/bbl",
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-08",
      "value": 2.9,
      "unit": "%"
    },
    {
      "seriesId": "CPI-US",
      "country": "US",
      "date": "2026-09",
      "value": 3.1,
      "unit": "%"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/macro-intelligence/event-impact-timeline$0.05 USDC

Build macro event impact timeline

Place supplied macro events on a timeline and attach nearby observations within 45 days. Causation is not claimed.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`series`	No	array; Array
`observations`	No	array; Array
`rates`	No	array; Array
`tenors`	No	array; Array
`releases`	No	array; Array
`priceLevels`	No	array; Array
`debt`	No	array; Array
`commodities`	No	array; Array
`events`	No	array; Array
`worldBank`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "events": [
    {
      "id": "E-1",
      "date": "2026-09-17",
      "country": "US",
      "title": "FOMC decision",
      "kind": "policy",
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-09-01",
      "value": 4.1,
      "unit": "%"
    },
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-09-18",
      "value": 4,
      "unit": "%"
    },
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-10-01",
      "value": 4.05,
      "unit": "%"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "timed",
  "eventCount": 1,
  "items": [
    {
      "id": "E-1",
      "date": "2026-09-17",
      "country": "US",
      "title": "FOMC decision",
      "kind": "policy",
      "source": "Caller-supplied",
      "nearbyObservationCount": 3,
      "nearbyObservations": [
        {
          "seriesId": "UST10",
          "date": "2026-09-01",
          "value": 4.1,
          "unit": "%",
          "daysFromEvent": -16
        },
        {
          "seriesId": "UST10",
          "date": "2026-09-18",
          "value": 4,
          "unit": "%",
          "daysFromEvent": 1
        },
        {
          "seriesId": "UST10",
          "date": "2026-10-01",
          "value": 4.05,
          "unit": "%",
          "daysFromEvent": 14
        }
      ],
      "causationClaimed": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
    "No paid financial data provider is used and no API key is required.",
    "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
    "Country risk labels summarize supplied indicators only and are not a credit rating.",
    "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/macro-intelligence/event-impact-timeline" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "events": [
    {
      "id": "E-1",
      "date": "2026-09-17",
      "country": "US",
      "title": "FOMC decision",
      "kind": "policy",
      "source": "Caller-supplied"
    }
  ],
  "observations": [
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-09-01",
      "value": 4.1,
      "unit": "%"
    },
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-09-18",
      "value": 4,
      "unit": "%"
    },
    {
      "seriesId": "UST10",
      "country": "US",
      "date": "2026-10-01",
      "value": 4.05,
      "unit": "%"
    }
  ]
}
JSON