# SocialCrawl API — google_finance endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/google_finance

## GET /v1/google_finance/quote
Get a financial instrument quote
Credit cost: 5 (advanced)
Parameters:
- keyword (required) — Instrument identifier: TICKER:EXCHANGE for stocks/ETFs/indices ('GOOGL:NASDAQ', '.INX:INDEXSP') or a forex/crypto pair ('EUR-USD', 'BTC-USD'). Use the `id` returned by ticker-search.
- language (optional, string) — Language as a DFS name ('English') or 2-letter code ('en'). Defaults to English.
- location (optional, string) — Location as a DFS name ('United States') or numeric code ('2840'). Defaults to the US.
curl "https://www.socialcrawl.dev/v1/google_finance/quote?keyword=GOOGL:NASDAQ" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_finance/ticker-search
Search financial instruments by name
Credit cost: 1 (standard)
Parameters:
- keyword (required) — Company / instrument name to search for (e.g. 'Apple', 'Euro', 'Bitcoin').
- category (optional, enum: all | stock | index | mutual_fund | currency | futures) — Restrict to one instrument class: all (default), stock, index, mutual_fund, currency, or futures. A class with no matches returns an empty list.
- language (optional, string) — Language as a DFS name ('English') or 2-letter code ('en'). Defaults to English.
- location (optional, string) — Location as a DFS name ('United States') or numeric code ('2840'). Defaults to the US.
curl "https://www.socialcrawl.dev/v1/google_finance/ticker-search?keyword=Apple" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_finance/markets
Get a markets overview (indices + movers)
Credit cost: 1 (standard)
Parameters:
- language (optional, string) — Language as a DFS name ('English') or 2-letter code ('en'). Defaults to English.
- location (optional, string) — Location as a DFS name ('United States') or numeric code ('2840'). Defaults to the US.
curl "https://www.socialcrawl.dev/v1/google_finance/markets" \
  -H "x-api-key: sc_your_api_key_here"