Google Finance API endpoint
Lists Google Finance market movers. `categories` takes comma-separated numeric categories, `count` sets how many items to return (default 20) and `offset` skips ahead. Each item has its ticker, exchange, name, price, change and change percent, and previous close.
/google/finance/markets/moversQuery parameters:
categories: optional comma-separated numeric categoriescount: optional result count, defaults to 20offset: optional result offset| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| ticker | 20 | “CIFR” and 19 other values |
| exchange | 20 | NASDAQ (13), NYSE (7) |
| name | 20 | “Cipher Digital Inc” and 19 other values |
| type | 20 | stock (19), etf (1) |
| currency | 20 | USD in all 20 |
| price | 20 | 1.56 to 344.17, median 9.89 |
| change | 20 | -6.38 to 3.2, median -0.06 |
| change_percent | 20 | -10.5 to 21.9, median -1.21 |
| previous_close | 20 | 1.62 to 340.97, median 10.06 |
| timezone | 20 | America/New_York in all 20 |
| google_id | 20 | |
| country | 20 | US in all 20 |
| after_hours | 20 | |
| last_update_unix | 20 | 1,791,910,215 to 1,791,910,416, median 1,791,910,403 |
| identifier | 20 | “CIFR:NASDAQ” and 19 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| categories | string | No | Comma-separated numeric categories | ||
| count | integer | No | Result count | ||
| offset | integer | No | Result offset | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/google/finance/markets/movers?count=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"count": 20,
"items": [
{
"ticker": "AAPL",
"exchange": "NASDAQ",
"name": "Apple Inc"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/finance.marketMoversResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | finance.MarketMoversResponse | No | ||||
| data.categories | array | No | Numeric category ids the movers were filtered by. | |||
| data.count | integer | No | 20 | Number of instruments requested. | ||
| data.items | array | No | Market mover instruments. | |||
| data.items[].after_hours | object | No | Price and change in after-hours trading. | |||
| data.items[].after_hours.change | number | No | -3.37 | Price change, in the same unit as `price`. | ||
| data.items[].after_hours.change_percent | number | No | -1.3 | Price change as a percentage. | ||
| data.items[].after_hours.price | number | No | 255.65 | Price in after-hours trading. | ||
| data.items[].change | number | No | -3.37 | Price change shown by Google Finance, in the same unit as `price`. | ||
| data.items[].change_percent | number | No | -1.3 | Price change as a percentage, as Google Finance shows it. | ||
| data.items[].country | string | No | US | Country code of the instrument, for example `US`. | ||
| data.items[].currency | string | No | USD | Currency code the instrument is priced in, for example `USD`. | ||
| data.items[].exchange | string | No | NASDAQ | Exchange the instrument trades on, for example `NASDAQ`. | ||
| data.items[].google_id | string | No | /m/07zmbvf | Google's id for the instrument, for example `/m/07zmbvf`. | ||
| data.items[].identifier | string | No | AAPL:NASDAQ | Instrument identifier in `TICKER:EXCHANGE` form, for example `AAPL:NASDAQ`. Use it as the `quote` path parameter. | ||
| data.items[].last_update_unix | integer | No | 1777077000 | Time of the latest price update, in Unix seconds. | ||
| data.items[].name | string | No | Apple Inc | Instrument name, for example `Apple Inc`. | ||
| data.items[].previous_close | number | No | 236.35 | Closing price of the previous trading day. | ||
| data.items[].price | number | No | 255.65 | Latest price of the instrument. | ||
| data.items[].ticker | string | No | AAPL | Ticker symbol of the instrument. | ||
| data.items[].timezone | string | No | America/New_York | IANA time zone of the instrument's market, for example `America/New_York`. | ||
| data.items[].type | string | No | stock | Kind of instrument: `stock`, `index`, `crypto`, `etf` or `other`. | ||
| data.offset | integer | No | 0 | Number of instruments skipped before this page. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/google/finance/markets/movers?count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"