# Stock Prices by Finmap.io (`finmap/stock-prices`)

Generates the accurate current price and historical prices of stocks, at a low cost.
Historical intervals: Daily, weekly, and monthly.

We are committed to offering accurate financial data straight from the robust finmap.io API.
Contact us if you have any questions.

- **URL**: https://beta-securitybyobscurity.apify.com/finmap/stock-prices.md
- **Developed by:** [finmap.io](https://beta-securitybyobscurity.apify.com/finmap) (community)
- **Categories:** Developer tools, News, Other
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

# README

## Stock Prices by finmap.io 📈

Retrieve the **current and historical price data of stocks**, in preferred intervals.
This actor is ideal for startups, developers, AI agents, and market analysts who need accurate asset prices at affordable rates.
Pay only for what you need! Current rate is: $0.0005/row of results.

***

### Features

🕒 Fetch the current stock price.

📅 Fetch historical stock price data.

⚙️ Select your interval: `daily`, `weekly`, or `monthly`.

🌎 Find stocks from 62+ countries.

🧾 Clean output with structured fields.

⬇️ Export as CSV or your preferred file format.

💬 24h customer support for all subscribers.

💸 Avoid overspending by paying only $0.0005/row of result.

***

#### Terms of Service

This actor is designed to provide users with accurate and reliable market data.
However, the information and services provided by this tool are not intended as, and should not be construed as,
financial or investment advice. We are not responsible for any investment decisions made based on the data provided,
nor for any losses resulting from market fluctuations, errors, or inaccuracies in the data.

***

### Input Schema

| Field        | Type   | Required | Description |
|--------------|--------|----------|-------------|
| `exchange`   | string | ✅       | Choose between `"I Don't Know"` or `"..."` |
| `price_type` | string | ✅       | Choose between `"latest"` or `"historical"` |
| `symbols`    | array  | ✅       | Supported values: `BTCUSDT`, `ETHUSDT` |
| `startDate`  | string | ❌       | Required for `historical` pricing (`YYYY-MM-DD`) |
| `endDate`    | string | ❌       | Required for `historical` pricing (`YYYY-MM-DD`) |
| `interval`   | string | ❌       | One of: `daily`, `weekly`, `monthly` (used only for historical) |
| `order`      | boolean| ❌       | Switch: `true` or `false` (default) (used only for historical) |

***

### Example Latest Price

#### Input Schema

```json
{
  "symbols": [
    "AAPL",
    "MSFT"
  ],
  "exchange": "NASDAQ",
  "price_type": "latest"
}
```

#### Output Schema

```json
[
  {
    "symbol": "AAPL",
    "open": 226.875,
    "close": 230.03,
    "high": 230.45,
    "low": 226.65,
    "volume": 50208578,
    "datetime": "2025-09-12 06:38:27+00:00"
  },
  {
    "symbol": "MSFT",
    "open": 502.25,
    "close": 501.01,
    "high": 503.17,
    "low": 497.88,
    "volume": 18881608,
    "datetime": "2025-09-12 06:38:28+00:00"
  }
]
```

### Example Historical Price

#### Input Schema

```json
{
    "endDate": "2025-04-01",
    "exchange": "NASDAQ",
    "interval": "31",
    "order": false,
    "price_type": "historical",
    "startDate": "2025-01-01",
    "symbols": [
        "NVDA"
    ]
}
```

#### Output Schema

```json
[
  {
    "symbol": "NVDA",
    "open": 136,
    "close": 138.31,
    "high": 138.88,
    "low": 134.63,
    "volume": 198247166,
    "datetime": "2025-01-02"
  },
  {
    "symbol": "NVDA",
    "open": 114.75,
    "close": 116.66,
    "high": 118.57,
    "low": 113.01,
    "volume": 371235677,
    "datetime": "2025-02-03"
  },
  {
    "symbol": "NVDA",
    "open": 123.51,
    "close": 114.06,
    "high": 123.7,
    "low": 112.28,
    "volume": 411381373,
    "datetime": "2025-03-03"
  },
  {
    "symbol": "NVDA",
    "open": 108.515,
    "close": 110.15,
    "high": 110.2,
    "low": 106.47,
    "volume": 222614034,
    "datetime": "2025-04-01"
  }
]
```

# Actor input Schema

## `exchange` (type: `string`):

Choose the exchange from which you want to fetch the price.

## `symbols` (type: `array`):

Please input your stock symbol(s) here. Max 5 symbols are allowed. Example: AAPL

## `price_type` (type: `string`):

Choose whether to fetch the latest price or historical price data.

## `startDate` (type: `string`):

For historical prices, the start date (YYYY-MM-DD) from which to begin fetching data.

## `endDate` (type: `string`):

For historical prices, the end date (YYYY-MM-DD) up to which to fetch data.

## `interval` (type: `string`):

Price interval by day for weekly value should be 6, Monthly value should be 31 etc.

## `order` (type: `boolean`):

Historical price information order. Switch off for assending order and switch on for decending order.

## Actor input object example

```json
{
  "exchange": "None",
  "symbols": [
    "NVDA",
    "MSFT",
    "AAPL"
  ],
  "price_type": "latest",
  "interval": "1"
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbols": [
        "NVDA",
        "MSFT",
        "AAPL"
    ],
    "order": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("finmap/stock-prices").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "symbols": [
        "NVDA",
        "MSFT",
        "AAPL",
    ],
    "order": False,
}

# Run the Actor and wait for it to finish
run = client.actor("finmap/stock-prices").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbols": [
    "NVDA",
    "MSFT",
    "AAPL"
  ],
  "order": false
}' |
apify call finmap/stock-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=finmap/stock-prices",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Stock Prices by Finmap.io",
        "description": "Generates the accurate current price and historical prices of stocks, at a low cost.\nHistorical intervals: Daily, weekly, and monthly.\n \nWe are committed to offering accurate financial data straight from the robust finmap.io API.\nContact us if you have any questions.",
        "version": "1.0",
        "x-build-id": "NxmlnPstzGT9q50pH"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/finmap~stock-prices/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-finmap-stock-prices",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/finmap~stock-prices/runs": {
            "post": {
                "operationId": "runs-sync-finmap-stock-prices",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/finmap~stock-prices/run-sync": {
            "post": {
                "operationId": "run-sync-finmap-stock-prices",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "symbols",
                    "price_type"
                ],
                "properties": {
                    "exchange": {
                        "title": "Exchange",
                        "enum": [
                            "None",
                            "AMEX",
                            "AQUIS",
                            "ASX",
                            "BER",
                            "BIST",
                            "BME",
                            "BMFBOVESPA",
                            "BSE",
                            "BVB",
                            "BX",
                            "CBOE",
                            "CRYPTOCAP",
                            "CSE",
                            "CSECY",
                            "DUS",
                            "EURONEXT",
                            "EUROTLX",
                            "FSE",
                            "FWB",
                            "GETTEX",
                            "GPW",
                            "HAM",
                            "HAN",
                            "HKEX",
                            "HNX",
                            "HOSE",
                            "IDX",
                            "JSE",
                            "KRX",
                            "LS",
                            "LSE",
                            "LSIN",
                            "LSX",
                            "LUXSE",
                            "MARKETSCOM",
                            "MIL",
                            "MUN",
                            "MYX",
                            "NAG",
                            "NASDAQ",
                            "NEO",
                            "NEWCONNECT",
                            "NGM",
                            "NSE",
                            "NYSE",
                            "OMXCOP",
                            "OMXSTO",
                            "OMXTSE",
                            "OMXVSE",
                            "OSL",
                            "OTC",
                            "PSE",
                            "RUS",
                            "SAPSE",
                            "SET",
                            "SIX",
                            "SPARKS",
                            "SSE",
                            "SWB",
                            "SZSE",
                            "TADAWUL",
                            "TPEX",
                            "TRADEGATE",
                            "TSE",
                            "TSX",
                            "TSXV",
                            "TVC",
                            "TWSE",
                            "UPCOM",
                            "VIE",
                            "XETR"
                        ],
                        "type": "string",
                        "description": "Choose the exchange from which you want to fetch the price.",
                        "default": "None"
                    },
                    "symbols": {
                        "title": "Stock Symbol(s)",
                        "minItems": 1,
                        "maxItems": 5,
                        "type": "array",
                        "description": "Please input your stock symbol(s) here. Max 5 symbols are allowed. Example: AAPL",
                        "items": {
                            "type": "string"
                        }
                    },
                    "price_type": {
                        "title": "Price Type",
                        "enum": [
                            "latest",
                            "historical"
                        ],
                        "type": "string",
                        "description": "Choose whether to fetch the latest price or historical price data.",
                        "default": "latest"
                    },
                    "startDate": {
                        "title": "Start Date",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
                        "type": "string",
                        "description": "For historical prices, the start date (YYYY-MM-DD) from which to begin fetching data."
                    },
                    "endDate": {
                        "title": "End Date",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
                        "type": "string",
                        "description": "For historical prices, the end date (YYYY-MM-DD) up to which to fetch data."
                    },
                    "interval": {
                        "title": "Interval",
                        "enum": [
                            "1",
                            "7",
                            "31"
                        ],
                        "type": "string",
                        "description": "Price interval by day for weekly value should be 6, Monthly value should be 31 etc.",
                        "default": "1"
                    },
                    "order": {
                        "title": "Decending Order",
                        "type": "boolean",
                        "description": "Historical price information order. Switch off for assending order and switch on for decending order."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
