Skip to main content
GET
/
api
/
consumer-prices
/
v1
/
list-consumer-price-movers
ListConsumerPriceMovers
curl --request GET \
  --url https://api.example.com/api/consumer-prices/v1/list-consumer-price-movers
{
  "marketCode": "<string>",
  "asOf": "<string>",
  "range": "<string>",
  "risers": [
    {
      "productId": "<string>",
      "title": "<string>",
      "category": "<string>",
      "retailerSlug": "<string>",
      "changePct": 123,
      "currentPrice": 123,
      "currencyCode": "<string>"
    }
  ],
  "fallers": [
    {
      "productId": "<string>",
      "title": "<string>",
      "category": "<string>",
      "retailerSlug": "<string>",
      "changePct": 123,
      "currentPrice": 123,
      "currencyCode": "<string>"
    }
  ],
  "upstreamUnavailable": true
}

Documentation Index

Fetch the complete documentation index at: https://worldmonitor.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

market_code
string

market_code is the ISO 3166-1 alpha-2 market identifier.

range
string

range is one of "7d", "30d", "90d".

limit
integer<int32>

limit caps the number of risers and fallers returned (default 10).

category_slug
string

category_slug filters to a single category when set.

Response

Successful response

ListConsumerPriceMoversResponse holds the top price movers.

marketCode
string

market_code echoes the requested market.

asOf
string<int64>

as_of is the Unix millisecond timestamp of the snapshot.

range
string

range echoes the requested range.

risers
object[]
fallers
object[]
upstreamUnavailable
boolean

upstream_unavailable is true when the companion service could not be reached.