Top movers
The biggest gaining and losing commodities over the requested period.
Authorizations
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
Period the movers are computed over.
| Value | Description |
|---|---|
mtd | Month-to-date |
mtd Number of gainers and losers to return (1–10).
1 <= x <= 10Response
Top gaining and losing commodities.
Standard success envelope shared by every endpoint. Each operation's response
wrapper extends this (via allOf) and adds a typed data property.
Always true for a successful response.
true
Mirrors the HTTP status code.
200
Top gaining and losing commodities over a period.
Response metadata. Always present; timestamp is the server time the response was generated.