FREE QUICKSTART

Your first useful request.

Read macro reference data, understand its dates and units, then bring it into your own workflow. No wallet or API key.

Looking for the testnet payment guide? Orderbook Audit has its own walkthrough.

Make one free request.

Run this command in your terminal, or open the browser tool and click Run request. Reading this guide does not fetch market data.

GET /v1/macro/context

curl 'https://lahamu.xyz/v1/macro/context'

The free host may take about a minute to wake up. Source observations can be older than the fetch time; a 30-minute cache does not refresh their dates.

Read the scope, not just the value.

Status

Check data.status and each source. partial means some observations need care; unavailable is not a zero rate.

Observation dates

SOFR, EFFR and FX can have different observation_date values. evaluated_at is the evaluation time, not their release time.

Units & calculations

Rates use percent_per_annum. EUR/USD is USD per EUR; USD/KRW is a Lahamu cross-rate calculation in KRW per USD. These are reference values, not executable quotes.

Synthetic partial-response excerpt — for interpretation only. No live rates are shown; this is not a complete API response.

SYNTHETIC / EXCERPT

{
  "kind": "macro_context",
  "data": {
    "status": "partial",
    "effr": {
      "status": "unavailable",
      "error": "upstream_unavailable"
    }
  }
}

Here, EFFR is unavailable. Do not invent a value or assume the other sources are current. Inspect the full response, including its notices, before forming an answer.

Bring the result into your workflow.

Use HTTP directly or install the local MCP adapter for four free tools. Keep observation dates, units, errors and source notices in any displayed or summarized output.

Connection guide →Read the API contract

Tell us what happened.

We are looking for two independent developers to try a tool in their own environment. Describe its status, dates and units, and whether it fits your work. A browser preview is a first look; it is separate from an independent integration trial.

FEEDBACK TEMPLATE

Lahamu trial: data_context
Tool / access method:
Run date / result status:
Observation dates / units:
My workflow / current alternative:
Applied: yes / no / not yet
Assistance received: yes / no
What helped or blocked me:
Would I use it again? Under what conditions?

Copy and complete this template locally. Nothing is submitted here. Share only non-sensitive details; leave out credentials, payment signatures and private data.

Optional: visit Lahamu on X ↗

Sources and reuse notices

Federal Reserve Bank of New York

The SOFR and EFFR data is subject to the Terms of Use posted at newyorkfed.org. The New York Fed is not responsible for publication of the SOFR and EFFR data by Lahamu, does not sanction or endorse any particular republication, and has no liability for your use.

Lahamu is not affiliated with the New York Fed. The New York Fed does not sanction, endorse, or recommend any products or services offered by Lahamu.

The Secured Overnight Financing Rate (SOFR) Data and Broad General Collateral Rate (BGCR) Data are calculated using data provided under a license granted to the New York Fed by DTCC Solutions LLC (“Solutions”), an affiliate of The Depository Trust & Clearing Corporation. Solutions, its affiliates, and third parties from which they obtained data have no liability for the content of this material.

NY Fed content remains available under the same permissions, conditions and restrictions in its Terms of Use; Lahamu adds no restrictions to that content.

Original SOFR/EFFR observations are published by the New York Fed. Basis-point changes are calculated by Lahamu as (current rate minus previous rate) × 100; these changes are not calculations published by the New York Fed. Age/status screening is also performed by Lahamu.

Original source data · Source terms

European Central Bank

Original ECB observations are available free of charge from the ECB.

Keep ECB attribution and reproduce observations accurately. Identify modifications. For sold material, display the free-source notice before payment and on each access. ECB links must open outside embedded frames.

EUR/USD and observation dates are original ECB observations. USD/KRW is calculated by Lahamu as (KRW per EUR) / (USD per EUR) for the same observation date. USD/KRW percentage change is calculated by Lahamu against the previous observation. Age/status screening is also performed by Lahamu. These are reference rates, not executable FX quotes.

Original source data · Source terms