C# SDK engine

Google Finance

Карточка Google Finance для инструмента: summary, graph, markets, knowledge graph, новости, финансовая отчётность и похожие инструменты.

engine: google_finance constant: XylopSearchEngines.GoogleFinance GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleFinance,
    new Dictionary<string, string?>
    {
        ["q"] = "GOOGL:NASDAQ",
        ["hl"] = "en",
        ["window"] = "1D",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_finance
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_finance`	Движок Google Finance.
`q`	string	Да	GOOGL:NASDAQ	Тикер, индекс, фонд, валюта или futures.
`hl`	string	Нет	`en`	Язык интерфейса.
`window`	string	Нет	`1D`	1D, 5D, 1M, 6M, YTD, 1Y, 5Y или MAX.

Выходные параметры

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`summary`	object	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`graph`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`news_results`	array	пример ответа	Новостные результаты, источники, даты публикации и ссылки.

JSON

Пример ответа

{
  "search_metadata": {
    "status": "Success",
    "google_finance_url": "https://www.google.com/finance/quote/GOOGL:NASDAQ?hl=en"
  },
  "search_parameters": {
    "engine": "google_finance",
    "q": "GOOGL:NASDAQ",
    "hl": "en"
  },
  "summary": {
    "title": "Alphabet Inc Class A",
    "stock": "GOOGL",
    "exchange": "NASDAQ",
    "price": "$176.77",
    "extracted_price": 176.77,
    "currency": "USD",
    "price_movement": {
      "percentage": 1.1960682,
      "value": 2.0999982,
      "movement": "Up"
    }
  },
  "graph": [
    {
      "price": 174.95,
      "currency": "USD",
      "date": "Jun 16 2025, 09:30 AM UTC-04:00",
      "volume": 7413
    }
  ],
  "news_results": [
    {
      "title": "Top news",
      "items": [
        {
          "snippet": "The Best Stocks to Buy With $1,000 Right Now",
          "link": "https://example.com/finance-news",
          "source": "Example Finance"
        }
      ]
    }
  ]
}