diff --git a/content/api-reference/data/prices-api/prices-api-faq.mdx b/content/api-reference/data/prices-api/prices-api-faq.mdx index 52efa8dfd..59d655721 100644 --- a/content/api-reference/data/prices-api/prices-api-faq.mdx +++ b/content/api-reference/data/prices-api/prices-api-faq.mdx @@ -11,6 +11,12 @@ slug: reference/prices-api-faq For each token, the price is aggregated by averaging exchange prices (weighted by total volume). +### Which price does the Historical Token Prices endpoint return for each interval? + +Each data point returned by [Historical Token Prices](/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) is the opening price of its interval: the first price recorded in that interval. It is not an average across the interval or the closing price. + +The only exception is the most recent data point, which is the current live price. + ### What tokens do you support? By Symbol: We support the top 1000+ token symbols by market cap. diff --git a/src/openapi/prices/prices.yaml b/src/openapi/prices/prices.yaml index 93b9b128c..87fe91bcd 100644 --- a/src/openapi/prices/prices.yaml +++ b/src/openapi/prices/prices.yaml @@ -89,6 +89,7 @@ paths: summary: Historical Token Prices description: > Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address. + Each data point covers one `interval`, and its `value` is the opening price of that interval (the first price recorded in the interval). The only exception is the most recent data point, which is the current live price. tags: ["Prices API Endpoints"] parameters: - $ref: "#/components/parameters/apiKey" @@ -429,7 +430,7 @@ components: properties: value: type: string - description: Price value as a string. + description: Opening price of the interval (the first price recorded in the interval), as a string. For the most recent data point, this is the current live price. example: "1900.00" timestamp: type: string