---
title: "GET /google-finance/markets"
method: GET
path: "/google-finance/markets"
tags: ["GoogleFinance"]
---

# GET /google-finance/markets

`GET /google-finance/markets`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google-finance/markets`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `hl` string, nullable
- `gl` string, nullable
- `trend` 'indexes' | 'most-active' | 'gainers' | 'losers' | 'climate-leaders' | 'cryptocurrencies' | 'currencies' | 'null', nullable
- `index_market` 'americas' | 'europe-middle-east-africa' | 'asia-pacific' | 'null', nullable

## Response `200`

Markets data retrieved successfully. Returns either markets overview or trend data based on trend parameter

- object
  - `markets` object
    - `us` object[], required
      - `stock` string, required
      - `name` string, required
      - `symbol` string, required
      - `exchange` string, required
      - `price` number, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `europe` object[], required
      - `stock` string, required
      - `name` string, required
      - `symbol` string, required
      - `exchange` string, required
      - `price` number, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `asia` object[], required
      - `stock` string, required
      - `name` string, required
      - `symbol` string, required
      - `exchange` string, required
      - `price` number, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `currencies` object[], required
      - `stock` string, required
      - `name` string, required
      - `price` number, required
      - `from_currency` string, required
      - `to_currency` string, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `crypto` object[], required
      - `stock` string, required
      - `name` string, required
      - `price` number, required
      - `from_currency` string, required
      - `to_currency` string, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `futures` object[], required
      - `stock` string, required
      - `name` string, required
      - `symbol` string, required
      - `exchange` string, required
      - `price` number, required
      - `currency` string, required
      - `price_movement` object, required
        - `direction` string, required
        - `value` number, required
        - `percentage` number, required
    - `top_news` unknown, required
  - `market_trends` object[]
    - `title` string, required
    - `results` array[], required
      - unknown[]
        - unknown
  - `news_results` array[]
    - unknown[]
      - unknown

## Other responses

- `400`: Invalid characters in request parameters
- `401`: Unauthorized - API key is missing or invalid
- `404`: Error response
- `422`: Validation error - Invalid parameters provided
- `429`: Error response
- `500`: Error response
- `503`

---

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