diff --git a/apps/developer-hub/content/docs/price-feeds/pro/api/history.mdx b/apps/developer-hub/content/docs/price-feeds/pro/api/history.mdx index 935a6751c6..f17109e977 100644 --- a/apps/developer-hub/content/docs/price-feeds/pro/api/history.mdx +++ b/apps/developer-hub/content/docs/price-feeds/pro/api/history.mdx @@ -54,12 +54,22 @@ List all available price feed symbols, optionally filtered. Returns price data at a specific historical timestamp. + + The `timestamp` parameter must be a **Unix timestamp in microseconds** (not seconds or milliseconds). + For fixed-rate channels, the timestamp must be **exactly divisible** by the channel rate: + - `fixed_rate@50ms` — divisible by `50000` + - `fixed_rate@200ms` — divisible by `200000` + - `fixed_rate@1000ms` — divisible by `1000000` + + For example, `1704067200000000` is a valid timestamp for all channels (2024-01-01 00:00:00 UTC in microseconds). + + **Query Parameters** -| Parameter | Type | Required | Description | Example | -| ----------- | ---------- | -------- | ---------------------------------- | ------------------ | -| `ids` | `number[]` | Yes | Price feed IDs | `1,2` | -| `timestamp` | `number` | Yes | Unix timestamp in **microseconds** | `1704067200000000` | +| Parameter | Type | Required | Description | Example | +| ----------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | +| `ids` | `number[]` | Yes | Price feed IDs | `1,2` | +| `timestamp` | `number` | Yes | Unix timestamp in **microseconds**. For fixed-rate channels, must be divisible by the channel rate (e.g. `200000` for `fixed_rate@200ms`). | `1704067200000000` | --- diff --git a/apps/developer-hub/content/docs/price-feeds/pro/api/rest.mdx b/apps/developer-hub/content/docs/price-feeds/pro/api/rest.mdx index 2c55a8a144..96911c222e 100644 --- a/apps/developer-hub/content/docs/price-feeds/pro/api/rest.mdx +++ b/apps/developer-hub/content/docs/price-feeds/pro/api/rest.mdx @@ -29,9 +29,9 @@ Returns price data at a specific historical timestamp. All fields from `/v1/latest_price`, plus: -| Field | Type | Required | Description | -| ----------- | -------- | -------- | ------------------------------ | -| `timestamp` | `string` | Yes | Unix timestamp in microseconds | +| Field | Type | Required | Description | +| ----------- | -------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- | +| `timestamp` | `string` | Yes | Unix timestamp in **microseconds**. For fixed-rate channels, must be divisible by the channel rate (e.g. `200000` for `fixed_rate@200ms`). | For the full response schema — including price feed fields, signed payloads, and available properties — see the [Payload Reference](/price-feeds/pro/payload-reference).