Skip to main content
GET
/
openapi
/
v1
/
macro
/
market-recap
Latest macroeconomic market recap
curl --request GET \
  --url https://api.hayinsights.com/openapi/v1/macro/market-recap \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "statusCode": 200,
  "data": {
    "updateTime": "2024-01-15T15:30:00",
    "nikkeiJpxGold": [
      {
        "index": "Nikkei 225",
        "value": 38500.5,
        "changeValue": 120.3,
        "changePercent": 0.31,
        "datetime": "2024-01-15T15:30:00",
        "atClose": "2024-01-15T15:30:00"
      }
    ],
    "nikkeiJpxOil": [],
    "tokyoStockExchangeReit": [],
    "topix": [],
    "interbankRates3m": [
      {
        "index": "TIBOR 3M",
        "value": 0.08,
        "changeValue": 0.01,
        "changePercent": null,
        "datetime": "2024-01-15T15:30:00",
        "atClose": "2024-01-15T15:30:00"
      }
    ],
    "currencyRate": [
      {
        "index": "USD/JPY",
        "value": 148.5,
        "changeValue": 0.3,
        "changePercent": 0.2,
        "datetime": "2024-01-15T15:30:00",
        "atClose": "2024-01-15T15:30:00"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-06-19T08:50:42.493Z"
  }
}

Authorizations

X-API-Key
string
header
required

Your HayInsights API key (prefixed apk_). Create and manage keys in the HayInsights dashboard (Account → API keys).

Send it in the X-API-Key header on every request to /openapi/v1/*. Which data domains you may access and your request quota are both governed by the subscription plan attached to the key — see the Plans & features and Rate limits guides.

Response

Latest market recap snapshot.

Standard success envelope shared by every endpoint. Each operation's response wrapper extends this (via allOf) and adds a typed data property.

success
boolean
required

Always true for a successful response.

Example:

true

statusCode
integer
required

Mirrors the HTTP status code.

Example:

200

data
object
required

Latest macroeconomic market recap — a snapshot of Japanese equity / commodity indices, REITs, TOPIX, 3-month interbank rates and key currency rates.

Schema derived from the API's MarketRecapResponseDto: the live staging endpoint currently returns HTTP 500 (a known server-side bug), so this shape and its example are authored from the source DTO rather than harvested.

meta
object

Response metadata. Always present; timestamp is the server time the response was generated.