price_history

PREFER for HISTORICAL closing prices and daily returns on a specific past date or date range — “what did the S&P 500 close at on August 7”, “closing prices and daily returns for these four indices last Friday”, “AAPL close on 2026-06-30”. Accepts one or more Yahoo Finance symbols (indices ^GSPC/^IXIC/^DJI/^SOX/^RUT, stocks, ^TNX yields, GC=F commodities, BTC-USD crypto, EURUSD=X FX — same symbol space as get_quotes) plus start_date/end_date, and returns each trading day’s close WITH the previous close and the computed daily return percent, per symbol. Covers shares listed on exchanges worldwide through the Yahoo exchange suffix — EL.PA (EssilorLuxottica, Euronext Paris), FME.DE (Fresenius Medical Care, Xetra), RED.MC (Redeia, Bolsa de Madrid), EVO.ST (Evolution, Nasdaq Stockholm), ENI.MI, ASML.AS, NESN.SW, NOVO-B.CO, HSBA.L (London), 7203.T (Toyota, Tokyo), 0700.HK, 005930.KS, 2330.TW, BHP.AX, RELIANCE.NS, SHOP.TO, PETR4.SA — each result carries its currency and exchange; “last 6 daily closes of EssilorLuxottica on Euronext Paris” is one call. Also accepts an ISIN in place of a symbol (e.g. FR0000121667, DK0062498333): it is matched to the exchange listing and the row says which listing was chosen (resolved_from_isin, symbol, exchange, currency). An ISIN that trades on several exchanges needs the optional exchange argument (”.DE”, “Xetra”); without it the tool returns the candidate listings instead of choosing. Company names are not looked up. Keyless (Yahoo Finance). Use get_quotes for CURRENT prices; this tool is for any date in the past.

{
  "type": "object",
  "description": "Daily closes and returns per symbol. A symbol may be an ISIN: it is matched to its exchange listing; with several listings and no exchange hint the row has found:false and candidates.",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "requested": {
      "type": "number"
    },
    "served": {
      "type": "number"
    },
    "lookups": {
      "type": "number"
    },
    "dropped_symbols": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dropped_note": {
      "type": "string"
    },
    "partial": {
      "type": "boolean"
    },
    "partial_note": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "The listing symbol priced (for an ISIN, the resolved one); the ISIN itself when it could not be resolved"
          },
          "found": {
            "type": "boolean"
          },
          "error": {
            "type": "string"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "days": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "close": {
                  "type": "number"
                },
                "previous_close": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "daily_return_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "date",
                "close"
              ]
            }
          },
          "resolved_from_isin": {
            "type": "string",
            "description": "Present when the symbol asked for was an ISIN: the ISIN as given"
          },
          "resolution_note": {
            "type": "string",
            "description": "Which listing the ISIN was matched to and why"
          },
          "empty_reason": {
            "type": "string",
            "enum": [
              "unknown_isin",
              "several_listings",
              "exchange_hint_no_match",
              "lookup_failed"
            ],
            "description": "Why an ISIN produced no price"
          },
          "note": {
            "type": "string"
          },
          "candidates": {
            "type": "array",
            "description": "Listings to choose from when an ISIN has several (or the hint matched none)",
            "items": {
              "type": "object",
              "properties": {
                "symbol": {
                  "type": "string"
                },
                "exchange": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "exchange_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "currency": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "symbol"
              ]
            }
          }
        },
        "required": [
          "symbol",
          "found"
        ]
      }
    },
    "source": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "requested",
    "results"
  ]
}

{
  "mcpServers": {
    "market-recap": {
      "url": "https://gateway.pipeworx.io/market-recap/mcp"
    }
  }
}