fx_markets

Get curve analytics by currency

Returns a currency-level curve view from official-source government bond tenor nodes. Use view=nodes for raw node snapshots, view=slopes for curve-slope and inversion analytics, or view=forwards for derived forward-rate segments.

Curve Families:

  • Supported values: government_nominal.

Metrics:

  • Supported values: spot.

Views:

  • Supported values: nodes, slopes, forwards.

Authentication:

  • Requires an Individual or Business API key via ?api_key=<key> or X-API-Key.
get/v1/curves/{currency}

Request

  • Base URL: https://api.fxmacrodata.com
  • URL: https://api.fxmacrodata.com/v1/curves/{currency}
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

currency'AUD' | 'CAD' | 'CHF' | 'CNH' | 'CNY' | 'DKK' | 'EUR' | 'GBP' | 'ILS' | 'JPY' | 'KRW' | 'MYR' | 'NOK' | 'NZD' | 'PEN' | 'SEK' | 'THB' | 'USD' required

Currency code

Example:AUD

Required path parameter. Currency code Allowed values: AUD, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, KRW, MYR, NOK, NZD, PEN, SEK, THB, USD.

Query parameters

curve_family'government_nominal'

Official curve family to return.

Example:government_nominal

Optional query parameter. Official curve family to return. Allowed values: government_nominal.

metric'spot'

Curve metric to return.

Example:spot

Optional query parameter. Curve metric to return. Allowed values: spot.

view'nodes' | 'slopes' | 'forwards'

Curve view to return: nodes, slopes, or forwards.

Example:nodes

Optional query parameter. Curve view to return: nodes, slopes, or forwards. Allowed values: nodes, slopes, forwards.

method'derived_from_spot_nodes'

Forward derivation method used when view=forwards.

Example:derived_from_spot_nodes

Optional query parameter. Forward derivation method used when view=forwards. Allowed values: derived_from_spot_nodes.

datestring

Optional target date YYYY-MM-DD. The endpoint returns the latest available node per maturity up to this date, using a recent lookback window.

Example:2026-06-01

Optional query parameter. Optional target date YYYY-MM-DD. The endpoint returns the latest available node per maturity up to this date, using a recent lookback window.

as_ofstring nullable

Explicit UTC information cutoff for verified vintage replay; date means start of day.

Optional query parameter. Explicit UTC information cutoff for verified vintage replay; date means start of day.

availabilitystring

Source-public or captured-value availability clock.

Optional query parameter. Source-public or captured-value availability clock.

max_staleness_daysinteger nullable

Maximum reference-date age; defaults to 7 with as_of, otherwise 60.

Optional query parameter. Maximum reference-date age; defaults to 7 with as_of, otherwise 60.

require_common_dateboolean nullable

Require all populated curve nodes to share a reference date; defaults true with as_of.

Optional query parameter. Require all populated curve nodes to share a reference date; defaults true with as_of.

api_keystring

Your Individual or Business API key

Deprecated: legacy query-string API key. Still accepted so existing integrations keep working, but new integrations must send the key in the X-API-Key header (or Authorization: Bearer). A key is required for non-USD, paid-only, or full-history requests. Responses to requests authenticated this way carry a Deprecation header.

Response

Successful Response

researchobject nullable
currencystring required
curve_familystring required
viewstring
metricstring nullable
methodstring nullable
requested_datestring required
as_ofstring nullable
node_countinteger required
slope_countinteger nullable
inverted_countinteger nullable
segment_countinteger nullable
sourcesstring[] required
dataobject[] required

Changes

No recorded changes to this operation across all 1 revision of this API.