Skip to content

[docs-agent] Document that Historical Token Prices returns the opening price per interval - #1809

Open
alchemy-bot wants to merge 2 commits into
mainfrom
docs/historical-prices-opening-price
Open

alchemy-bot wants to merge 2 commits into
mainfrom
docs/historical-prices-opening-price

Conversation

@alchemy-bot

@alchemy-bot alchemy-bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Clarifies that the Historical Token Prices endpoint (POST /{apiKey}/tokens/historical) returns the opening price (first recorded price) of each interval. Confirmed by the Prices team in Slack after a customer question.

  • Endpoint description now states that each data point covers one interval and its value is the interval's opening price.
  • HistoricalPriceItem.value description changed from "Price value as a string." to "Opening price of the interval (the first price recorded in the interval), as a string."
  • Exception noted in all three places: the most recent data point is the current live price, not an opening price.
  • New Prices API FAQ entry: "Which price does the Historical Token Prices endpoint return for each interval?"

generate:rest and validate:rest pass. Prettier and eslint are clean on the changed files.

Note for reviewers

A live call with interval: 1h returns timestamps aligned to the hour (00:00, 01:00, ...), which suggests each timestamp marks the start of its interval. I left the timestamp description unchanged because that hasn't been confirmed. Happy to add it if the Prices team confirms.

Requested by

@caleighc (via Slack thread)

…g price per interval

Each data point from /tokens/historical is the opening price (first recorded price) of its interval. Updates the endpoint description, the value field description, and adds a Prices API FAQ entry.

Requested-by: @caleighc
@alchemy-bot
alchemy-bot requested a review from a team as a code owner November 20, 2026 15:10
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-20T15:11:55.164847Z 5e5dacf PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

github-actions Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ❌ Failed Nov 20, 2026, 3:12 PM

…ive price

The only exception to the opening-price rule on /tokens/historical is the most recent data point, which returns the current live price.

Requested-by: @caleighc

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant