---
title: "Google Finance top stocks by metric"
method: GET
path: "/google/finance/markets/top"
tags: ["Google"]
---

# Google Finance top stocks by metric

`GET /google/finance/markets/top`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/google/finance/markets/top`
- Auth: API key in header `x-api-key`

Lists the top Google Finance instruments for a ranking metric. `metric` is a Google Finance metric id (default 6) and `page` is the page number (default 1). Each item has its ticker, exchange, name, price, change and change percent, and previous close.

## Query parameters

- `metric` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FinanceTopStocksResponseDoc
  - `code` integer
  - `data` FinanceTopStocksResponse
    - `items` FinanceInstrument[]: Top instruments for the selected metric.
      - `after_hours` FinancePriceChange
        - `change` number: Price change, in the same unit as `price`.
        - `change_percent` number: Price change as a percentage.
        - `price` number: Price in after-hours trading.
      - `change` number: Price change shown by Google Finance, in the same unit as `price`.
      - `change_percent` number: Price change as a percentage, as Google Finance shows it.
      - `country` string: Country code of the instrument, for example `US`.
      - `currency` string: Currency code the instrument is priced in, for example `USD`.
      - `exchange` string: Exchange the instrument trades on, for example `NASDAQ`.
      - `google_id` string: Google's id for the instrument, for example `/m/07zmbvf`.
      - `identifier` string: Instrument identifier in `TICKER:EXCHANGE` form, for example `AAPL:NASDAQ`. Use it as the `quote` path parameter.
      - `last_update_unix` integer: Time of the latest price update, in Unix seconds.
      - `name` string: Instrument name, for example `Apple Inc`.
      - `previous_close` number: Closing price of the previous trading day.
      - `price` number: Latest price of the instrument.
      - `ticker` string: Ticker symbol of the instrument.
      - `timezone` string: IANA time zone of the instrument's market, for example `America/New_York`.
      - `type` string: Kind of instrument: `stock`, `index`, `crypto`, `etf` or `other`.
    - `metric` integer: Google Finance metric id that was applied.
    - `page` integer: Page number returned.
  - `msg` string

## Other responses

- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)