# Google Finance API guide



## Choose a Google Finance operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Other operations



- [Google Finance explore](https://www.monocrawl.com/docs/endpoints/google_finance/explore) — The Google Finance explore board of notable movers.

- [Google Finance markets](https://www.monocrawl.com/docs/endpoints/google_finance/markets) — A Google Finance market board: indexes, most active, gainers, losers, cryptocurrencies or currencies.



### Posts and media



- [Google Finance quote](https://www.monocrawl.com/docs/endpoints/google_finance/quote) — A quote from Google Finance: price, change, ranges, market cap and ratios.



### Search and discovery



- [Google Finance ticker search](https://www.monocrawl.com/docs/endpoints/google_finance/ticker-search) — Tickers matching a query on Google Finance.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/google_finance` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## google_finance/explore

`GET /v1/google_finance/explore`

The Google Finance explore board of notable movers.

*Google Finance explore*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | no | Optional theme — e.g. `tech` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_finance/explore?query=tech" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "as_of": "example",
      "change": 0,
      "change_percent": 0,
      "currency": "example",
      "exchange": "example",
      "group": "example",
      "name": "example",
      "platform": "example",
      "price": 0,
      "symbol": "example",
      "ticker": "example",
      "trend": "example",
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_finance/explore#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_finance/explore.json)


## google_finance/markets

`GET /v1/google_finance/markets`

A Google Finance market board: indexes, most active, gainers, losers, cryptocurrencies or currencies.

*Google Finance markets*

| Parameter | Required | Description |
| --- | --- | --- |
| `market` | no | indexes, most_active, gainers, losers, climate_leaders, cryptocurrencies or currencies Accepted values: indexes, most_active, gainers, losers, climate_leaders, cryptocurrencies, currencies. Case, spaces, hyphens and underscores are interchangeable. — e.g. `indexes` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_finance/markets" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "as_of": "example",
      "change": 0,
      "change_percent": 0,
      "currency": "example",
      "exchange": "example",
      "group": "example",
      "name": "example",
      "platform": "example",
      "price": 0,
      "symbol": "example",
      "ticker": "example",
      "trend": "example",
      "url": "https://example.com/example"
    }
  ],
  "market": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_finance/markets#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_finance/markets.json)


## google_finance/quote

`GET /v1/google_finance/quote`

A quote from Google Finance: price, change, ranges, market cap and ratios.

*Google Finance quote*

| Parameter | Required | Description |
| --- | --- | --- |
| `ticker` | yes | Ticker with exchange — e.g. `AAPL:NASDAQ` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_finance/quote?ticker=AAPL%3ANASDAQ" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "about": "example",
  "as_of": "example",
  "change": 0,
  "change_percent": 0,
  "currency": "example",
  "exchange": "example",
  "graph": [
    {
      "timestamp": "example",
      "value": 0,
      "volume": 0
    }
  ],
  "name": "example",
  "platform": "example",
  "price": 0,
  "symbol": "example",
  "ticker": "example",
  "trend": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_finance/quote#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_finance/quote.json)


## google_finance/ticker-search

`GET /v1/google_finance/ticker-search`

Tickers matching a query on Google Finance.

*Google Finance ticker search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Company or ticker text — e.g. `nvidia` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_finance/ticker-search?query=nvidia" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "as_of": "example",
      "change": 0,
      "change_percent": 0,
      "currency": "example",
      "exchange": "example",
      "name": "example",
      "platform": "example",
      "price": 0,
      "symbol": "example",
      "ticker": "example",
      "trend": "example",
      "url": "https://example.com/example"
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_finance/ticker-search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_finance/ticker-search.json)