C# SDK engine

Google Finance Markets

Рыночные секции Google Finance: индексы, активные инструменты, лидеры роста/падения, криптовалюты, валюты и новости.

engine: google_finance_markets constant: XylopSearchEngines.GoogleFinanceMarkets GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleFinanceMarkets,
    new Dictionary<string, string?>
    {
        ["trend"] = "indexes",
        ["hl"] = "en",
        ["gl"] = "us",
        ["index_market"] = "americas",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_finance_markets`	Движок Google Finance Markets.
`trend`	string	Да	`indexes`	indexes, most-active, gainers, losers, climate-leaders, cryptocurrencies или currencies.
`hl`	string	Нет	`en`	Язык интерфейса.
`gl`	string	Нет	`us`	Код страны.
`index_market`	string	Нет	americas	Для trend=indexes: americas, europe-middle-east-africa или asia-pacific.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_finance_markets_url": "https://www.google.com/finance/markets/indexes?hl=en"
  },
  "search_parameters": {
    "engine": "google_finance_markets",
    "trend": "indexes",
    "hl": "en"
  },
  "markets": {
    "us": [
      {
        "stock": ".DJI:INDEXDJX",
        "link": "https://www.google.com/finance/quote/.DJI:INDEXDJX",
        "name": "Dow Jones",
        "price": 31836.74,
        "price_movement": {
          "percentage": 0,
          "value": 0
        }
      }
    ]
  },
  "market_trends": [
    {
      "title": "Americas",
      "results": [
        {
          "stock": ".INX:INDEXSP",
          "link": "https://www.google.com/finance/quote/.INX:INDEXSP",
          "name": "S&P 500",
          "price": "3,859.11",
          "extracted_price": 3859.11
        }
      ]
    }
  ]
}