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.

Endpoint

GET /api/google-finance/markets
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

hl string Optional

Language code (default: en)

gl string Optional

Country code (default: us)

trend string Optional

Market trend filter. One of: indexes, most-active, gainers, losers, climate-leaders, cryptocurrencies, currencies

index_market string Optional

Regional filter for indexes trend. One of: americas, europe-middle-east-africa, asia-pacific. Only used when trend=indexes.

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/google-finance/markets?hl=en');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/google-finance/markets?hl=en');

return $response->json();
fetch('https://scrappa.co/api/google-finance/markets?hl=en', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/google-finance/markets?hl=en', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/google-finance/markets?hl=en', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/google-finance/markets?hl=en')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/google-finance/markets?hl=en", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/google-finance/markets?hl=en' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "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
    }
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home