---
title: "Price Changes"
method: POST
path: "/v1/price/changes/query"
tags: ["Market Data"]
---

# Price Changes

`POST /v1/price/changes/query`

This endpoint track price fluctuations in real-time with the Price Changes API. Monitor percentage changes over various time periods, including daily (1D), monthly (1M), yearly (1Y) and long-term (max).

## Request body

- PriceChangesQuery
  - `identifier` Identifier, required
    - `type` 'rp_entity_id', required
    - `value` union, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
      - string
      - string[]

## Response `200`

Successful Response

- PublicPriceChangesResponse
  - `results` PriceChanges[], required
    - `rp_entity_id` string, required — RavenPack internal entity identifier.
    - `target_identifier_id` string, required — The target identifier provided in the request, e.g., stock symbol.
    - `1D` number, nullable, required — The price change in the last 1 day.
    - `5D` number, nullable, required — The price change in the last 5 days.
    - `1M` number, nullable, required — The price change in the last 1 month.
    - `3M` number, nullable, required — The price change in the last 3 months.
    - `6M` number, nullable, required — The price change in the last 6 months.
    - `ytd` number, nullable, required — The price change in the last year to date.
    - `1Y` number, nullable, required — The price change in the last 1 year.
    - `3Y` number, nullable, required — The price change in the last 3 years.
    - `5Y` number, nullable, required — The price change in the last 5 years.
    - `10Y` number, nullable, required — The price change in the last 10 years.
    - `max` number, nullable, required — The price change in the last max years.
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)