Skip to main content
GET
Latest market news

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.

Query Parameters

tab
enum<string>

Restrict to one market. Equivalent to sending the matching category.

Available options:
all,
macroeconomic,
bond,
stock,
commodities,
forex,
crypto
category
enum<string>

Filter by display category. Prefer tab.

Available options:
macroeconomic,
bond,
stock,
commodities,
forex,
crypto
assetClass
enum<string>

Filter by asset class.

Available options:
crypto,
stock,
bond,
commodities,
forex
macroTopic
enum<string>

Filter by macro topic.

Available options:
politics,
central_banks,
macroeconomics
geography
enum<string>

Filter by region. global also covers apac and europe.

Available options:
us,
japan,
vietnam,
global
sourceCode
string

Filter by source.

Example:

"cnbc-markets"

keyword
string

Only articles mentioning this keyword.

Example:

"inflation"

limit
integer
default:5

Articles to return.

Required range: 1 <= x <= 20
offset
integer
default:0

Articles to skip, for paging.

Required range: x >= 0

Response

One page of articles, newest first.

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

One page of articles. total counts every article matching the filters, not just this page — page through the remainder with offset.

meta
object

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