# Get Markets Overview

Get a comprehensive overview of global financial markets from Google Finance. Without the trend parameter, returns a summary of US, European, and Asian market indices, currencies, cryptocurrencies, and futures. With the trend parameter, returns detailed market trend data (gainers, losers, most active, indexes, climate leaders, cryptocurrencies, currencies) including market_trends and news_results. When a market mover needs deeper ticker-level data, open the [Google Finance quote API](/docs/google-finance-api/google_finance_quote).

- **Documentation:** [https://scrappa.co/docs/google-finance-api/google_finance_markets](https://scrappa.co/docs/google-finance-api/google_finance_markets)
- **API group:** Google Finance API
- **Endpoint:** `GET https://scrappa.co/api/google-finance/markets`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hl` | string | No | Language code (default: en) |
| `gl` | string | No | Country code (default: us) |
| `trend` | string | No | Market trend filter. One of: indexes, most-active, gainers, losers, climate-leaders, cryptocurrencies, currencies |
| `index_market` | string | No | Regional filter for indexes trend. One of: americas, europe-middle-east-africa, asia-pacific. Only used when trend=indexes. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-finance/markets?hl=en"
```

## Example response

```json
{
    "markets": {
        "us": [
            {
                "stock": ".DJI:INDEXDJX",
                "name": "Dow Jones Industrial Average",
                "symbol": ".DJI",
                "exchange": "INDEXDJX",
                "price": 42515.09,
                "price_movement": {
                    "direction": "Down",
                    "value": -125.69,
                    "percentage": -0.3
                }
            }
        ],
        "europe": [
            {
                "stock": "DAX:INDEXDB",
                "name": "DAX PERFORMANCE-INDEX",
                "symbol": "DAX",
                "exchange": "INDEXDB",
                "price": 22539.98,
                "price_movement": {
                    "direction": "Up",
                    "value": 74.25,
                    "percentage": 0.33
                }
            }
        ],
        "asia": [
            {
                "stock": "NI225:INDEXNIKKEI",
                "name": "Nikkei 225",
                "symbol": "NI225",
                "exchange": "INDEXNIKKEI",
                "price": 38776.94,
                "price_movement": {
                    "direction": "Down",
                    "value": -312.04,
                    "percentage": -0.8
                }
            }
        ],
        "currencies": [
            {
                "stock": "EUR-USD",
                "name": "EUR / USD",
                "price": 1.0457,
                "from_currency": "EUR",
                "to_currency": "USD",
                "price_movement": {
                    "direction": "Up",
                    "value": 0.0012,
                    "percentage": 0.11
                }
            }
        ],
        "crypto": [
            {
                "stock": "BTC-USD",
                "name": "Bitcoin",
                "price": 96159.8,
                "from_currency": "BTC",
                "to_currency": "USD",
                "price_movement": {
                    "direction": "Down",
                    "value": -1500.2,
                    "percentage": -1.54
                }
            }
        ],
        "futures": [
            {
                "stock": "YMW00:CBOT",
                "name": "Dow Futures",
                "symbol": "YMW00",
                "exchange": "CBOT",
                "price": 42622,
                "currency": "USD",
                "price_movement": {
                    "direction": "Up",
                    "value": 47,
                    "percentage": 0.11
                }
            }
        ],
        "top_news": null
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | No markets data found |  |
|  | Rate limited |  |
|  | Google Finance request failed |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)