Skip to main content
GET
GetPriceHistory

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

symbols
string
required

Comma-separated Yahoo symbols, at most 4 (e.g. "GC=F,SI=F"). Only symbols carried by the commodity, market and Gulf quote sets are served; others are reported in unavailable. A single string because the widget relay sets each query parameter once.

Pattern: ^ *[A-Za-z0-9^=.&-]{1,20} *(, *[A-Za-z0-9^=.&-]{1,20} *){0,3}$
range
string

Lookback window: 1mo, 3mo, 6mo or 1y. Empty means 3mo.

Pattern: ^(1mo|3mo|6mo|1y)?$
jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

GetPriceHistoryResponse contains one series per served symbol.

range
string

The lookback window that was served.

series
object[]
unavailable
string[]

Requested symbols reported unavailable because they are outside the tracked set or Yahoo could not serve them.