Plan: Professional and above · Credits: 1 per call
What You Can Use Benchmarks For
Compute a stock’s return relative to the market it trades in. Measure a company’s exposure to a commodity it buys or sells. Build a long backtest baseline, which company prices cannot support at one year of history. Compare regional markets over a decade.Benchmarks Cover Indices and Commodities, Not Companies
No company identifier works on this endpoint. It serves benchmark symbols only. For a company’s own price series, use Daily Prices.Look Up the Benchmark Symbol First
Passsearch with a name — gold, Nikkei, DAX — to get the registry back, optionally narrowed with kind to index or commodity. Search takes precedence when both search and symbol are supplied.
Read close_major for a Commodity
Weekend Rows Are Real
A benchmark row on a Saturday or Sunday is not an error. The Saudi and Egyptian markets trade on Sunday, CBOT grains run a Sunday-evening session, and a few calculated indices restate Friday’s value on Saturday. Do not filter weekend rows out as bad data.Key Benchmark Fields
Each row carries the benchmarksymbol, the date, the open, high, low and close, currency, and the close_major and currency_major pair described above. The registry rows returned by search carry the symbol, its name and its kind.
Benchmarks Date Convention
Each row is the session on that date on the benchmark’s own calendar, which as noted is not always a weekday. History runs from 2015 and rows are returned newest first.Benchmarks Sources
Index and commodity prices come from market data vendors, in the vendor’s own symbol space — which is why the symbols must be looked up rather than constructed.Query Benchmarks
Use the benchmarks endpoint to look a symbol up, then to fetch its series.string
A name or symbol to look up instead of fetching a series, for example
gold or Nikkei. Returns the registry.string
Restrict a search to
index or commodity.string
The benchmark symbol whose series to fetch, for example
^GSPC, ^N225, GCUSD, CLUSD.string
Earliest date,
YYYY-MM-DD. date_lte sets the ceiling.integer
default:"100"
Rows per page, between 1 and 1000. Page through with
cursor.